Create an organization-creation invite token

Creates a single organization-creation invite token. The token can be redeemed exactly once via POST /organizations with the X-Invite-Token header set, to create a new organization on the fly. To mint a batch (e.g. for an outreach campaign), call this endpoint once per token — the operation is independent per call so per-invite settings (boundEmail, expiresAt) can vary freely.

POST/invites

Authorization

bearerAuth

AuthorizationBearer <token>

In: header

Request Body

application/json

An organization-creation invite token. Tokens are short, case-insensitive signup codes (e.g. ABCDE-FGHJK) — they are the natural id for the resource and are returned by all reads.

boundEmail?string

Optional. If set, restricts redemption to a caller with this email (case-insensitive). Leave unset for open invites — typical for outreach campaigns. Honored on POST /invites; immutable thereafter.

expiresAt?string

ISO 8601 timestamp at which the invite expires. On POST /invites, defaults to now + 30 days; server caps at now + 90 days. Immutable thereafter.

Formatdate-time

Response Body

`application/json`

curl --request POST \  --url 'https://example.com/invites' \  --header 'Authorization: Bearer <token>' \  --header 'Content-Type: application/json' \  --data '{}'

{  "token": "string",  "boundEmail": "string",  "expiresAt": "2019-08-24T14:15:22Z",  "createdBy": "string",  "createdAt": "2019-08-24T14:15:22Z",  "consumedAt": "2019-08-24T14:15:22Z",  "consumedBy": "string",  "consumedOrganizationName": "string"}

Create an organization-creation invite token

Authorization

Request Body

Response Body

200application/json

400application/json

401application/json

403application/json

`application/json`

`application/json`

`application/json`

`application/json`