Invite a user

Invites a person to the account by email. Reactor emails them a link. They follow it, sign up or sign in to the dashboard, and accept. Only an account_admin of the account may invite.

The invitation is bound to the address you send. Only a signed-in user whose verified email matches it can accept. Addresses with a + tag in the local part are rejected, because the match is exact.

The invitee gets the roles in roles when they accept, developer by default. Invitations expire after 7 days. Only one pending invitation may exist per address per account.

POST

accounts

{account_id}

invites

curl --request POST \
  --url https://api.reactor.inc/accounts/{account_id}/invites \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "email": "alice@acme.example"
}
'

{
  "invite_id": "1f2e3d4c-5555-6666-7777-abcdef012345",
  "email": "alice@acme.example",
  "expires_at": "2025-07-08T16:00:00Z"
}

{
  "error": "<string>",
  "message": "<string>",
  "resource": "<string>",
  "reason": "<string>"
}

{
  "error": "<string>",
  "message": "<string>",
  "resource": "<string>",
  "reason": "<string>"
}

{
  "error": "<string>",
  "message": "<string>",
  "resource": "<string>",
  "reason": "<string>"
}

{
  "error": "a pending invite already exists for this email"
}

{
  "error": "<string>",
  "message": "<string>",
  "resource": "<string>",
  "reason": "<string>"
}

{
  "error": "<string>",
  "message": "<string>",
  "resource": "<string>",
  "reason": "<string>"
}

Authorizations

Authorization

string

header

required

A Reactor API key (rk_...), sent as Authorization: Bearer rk_.... Keep it on a server.

Path Parameters

account_id

string<uuid>

required

The account's ID. Use the account_id from GET /me.

Body

application/json

string<email>

required

The recipient's address. Plus-tagged addresses are rejected.

roles

enum<string>[]

The roles granted on accept. Defaults to ["developer"].

Available options:

developer,

account_admin,

billing_admin

Response

The invitation was recorded and the email was sent.

invite_id

string<uuid>

required

string<email>

required

expires_at

string<date-time>

required

When the link expires, as an RFC 3339 timestamp.

⌘I

curl --request POST \
  --url https://api.reactor.inc/accounts/{account_id}/invites \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "email": "alice@acme.example"
}
'

{
  "invite_id": "1f2e3d4c-5555-6666-7777-abcdef012345",
  "email": "alice@acme.example",
  "expires_at": "2025-07-08T16:00:00Z"
}

{
  "error": "<string>",
  "message": "<string>",
  "resource": "<string>",
  "reason": "<string>"
}

{
  "error": "<string>",
  "message": "<string>",
  "resource": "<string>",
  "reason": "<string>"
}

{
  "error": "<string>",
  "message": "<string>",
  "resource": "<string>",
  "reason": "<string>"
}

{
  "error": "a pending invite already exists for this email"
}

{
  "error": "<string>",
  "message": "<string>",
  "resource": "<string>",
  "reason": "<string>"
}

{
  "error": "<string>",
  "message": "<string>",
  "resource": "<string>",
  "reason": "<string>"
}

Get started

SDK Reference

CLI Reference

Platform API Reference

Endpoints

Invite a user

Authorizations

Path Parameters

Body

Response