Skip to main content
Creates an invitation and sends the invitee an email with an accept link. The link expires after 7 days. One live invitation per email per team: if a pending one already exists, this returns 409 — revoke it first to re-invite. There is no resend endpoint; re-invite = revoke + create (the same email reactivates the same invitation with a fresh link). Invitation creation is capped per team per UTC day (default 50, counting created invitations). On exceed you get 429 with a Retry-After header.
Permission required: member:invite

Headers

string
Optional. Retrying with the same value replays the first result instead of sending a second email.

Request Body

string
required
Invitee email — a bare address, no display name
string
required
Role on acceptance: tenant_admin, tenant_member, or a custom role key. The owner role cannot be invited.

Response

object