DevelopersAPI referenceAuth & accountsInvitations
Invite people
Full sessions only; team orgs only; org.members.manage. kind "email" (default) returns {invitations: [...]} one per valid email (each single-use, 14-day TTL, requested role honored). kind "link" returns {invitation: {..., url}} — always role member, unlimited uses.
View as MarkdownAuthorization
bearer AuthorizationBearer <token>
In: header
Path Parameters
id*string
Request Body
application/json
TypeScript Definitions
Use the request body type in TypeScript.
Response Body
application/json
application/json
application/json
application/json
application/json
application/json
curl -X POST "https://example.com/v1/orgs/string/invitations" \ -H "Content-Type: application/json" \ -d '{}'{ "invitations": [ { "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08", "kind": "string", "email": "string", "role": "string", "invited_by": "string", "max_uses": 0, "use_count": 0, "expires_at": "2019-08-24T14:15:22Z", "created_at": "2019-08-24T14:15:22Z", "url": "string", "dev_link": "string" } ]}