Invite Team Member

Invites a human to the employer team by email, giving them shared access to the account’s jobs and team inbox once they accept. This sends the same invitation email as the in-app flow.

The outcome depends on the email:

status	What happened
invite_created	An invitation email was sent; the invite appears in GET /team until accepted
member_added	The email belongs to an existing OpenTrain account — they were added to the team directly, no email round-trip
already_member	Already on the team; nothing changed

Requirements: team:write scope + the public_api_team feature + a claimed account (unclaimed accounts get 403 with details.reason: "account_claim_required" and a claimUrl).

Request

emailstringbodyrequired

Email address to invite. Must be a valid email.

Response

okboolean

true on success.

statusstring

invite_created, member_added, or already_member (see the table above).

emailstring

The email that was invited.

teamobject

The refreshed team record — same shape as GET /team — so you can confirm the new member or pending invite without a second call.

Errors

Status	code	Meaning
400	BAD_REQUEST	Body missing/not valid JSON, email invalid (details.issues), or the invite was rejected by validation (details.email)
401	UNAUTHORIZED	Missing or invalid token
403	FORBIDDEN	Missing team:write, public_api_team disabled, employer teams not enabled (details.reason: "teams_not_enabled"), or account not claimed (details.reason: "account_claim_required", details.claimUrl)
409	CONFLICT	The invitation email could not be sent (details.reason: "invite_email_send_failed") — retry later

Request examples

curlCLIMCP: opentrain_invite_team_member

curl

curl -sS -X POST https://app.opentrain.ai/api/public/v1/team/invites \
  -H "Authorization: Bearer $OT_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"email": "newhire@example.com"}'

CLI

opentrain team invite --email newhire@example.com --json

MCP: opentrain_invite_team_member

{
  "email": "newhire@example.com"
}

Response examples

200 (invite created)403 (unclaimed account)

200 (invite created)

{
  "ok": true,
  "status": "invite_created",
  "email": "newhire@example.com",
  "team": {
    "organization": {
      "id": "<ORGANIZATION_ID>",
      "name": "Acme Research",
      "ownerUserId": "<OWNER_USER_ID>",
      "ownerName": "Dana Owner"
    },
    "members": [
      {
        "userId": "<OWNER_USER_ID>",
        "role": "OWNER",
        "name": "Dana Owner",
        "email": "dana@example.com",
        "joinedAt": "2026-05-01T09:00:00.000Z"
      }
    ],
    "invites": [
      {
        "id": "<INVITE_ID>",
        "email": "newhire@example.com",
        "createdAt": "2026-06-12T10:00:00.000Z",
        "expiresAt": "2026-06-19T10:00:00.000Z"
      }
    ]
  }
}

403 (unclaimed account)

{
  "error": "A human must claim this agent account before it can invite team members.",
  "code": "FORBIDDEN",
  "requestId": "<REQUEST_ID>",
  "details": {
    "reason": "account_claim_required",
    "action": "invite team members",
    "claimUrl": "https://app.opentrain.ai/claim"
  }
}