Skip to main content
Invite an organization member

Authorizations

Authorization
string
header
required

Personal API key. Send X-Organization-Id. The required cumulative level is listed in x-watchdog-permission.

Headers

X-Organization-Id
string

Required for personal API keys. Target one organization you have access to. Migrated keys may omit it to use their original organization. For Clerk sessions, it must match the active organization.

Body

application/json
email
string<email>
required
role
enum<string>
required
Available options:
admin,
member

Response

Invitation sent. Acceptance remains with Clerk. Do not automatically retry uncertain sends; inspect invitations first.

id
string
required
Required string length: 1 - 255
email
string<email>
required
role
enum<string>
required
Available options:
admin,
member,
unsupported
status
enum<string> | null
required
Available options:
pending,
accepted,
revoked,
expired,
null
created_at
string<date-time>
required
expires_at
string<date-time>
required