Skip to main content
POST
/
api
/
v1
/
members
Add account member
curl --request POST \
  --url https://api.rafftechnologies.com/api/v1/members \
  --header 'Content-Type: application/json' \
  --header 'X-API-Key: <api-key>' \
  --data '
{
  "email": "jsmith@example.com",
  "target_user_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "api_key_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "role_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a"
}
'
{
  "success": true,
  "data": {
    "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
    "email": "jsmith@example.com",
    "account_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
    "user_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
    "role": "<string>",
    "role_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
    "role_name": "Operator",
    "invited_by": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
    "invited_at": "2023-11-07T05:31:56Z",
    "accepted_at": "2023-11-07T05:31:56Z",
    "invitation_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
    "invitation_expires_at": "2023-11-07T05:31:56Z",
    "created_at": "2023-11-07T05:31:56Z",
    "updated_at": "2023-11-07T05:31:56Z"
  }
}
Updated May 8, 2026

Authorizations

​
X-API-Key
string
header
required

API key for authentication. Each key is bound to a specific account.

Body

application/json
​
email
string<email>

Email to invite. Mutually exclusive with target_user_id and api_key_id.

​
target_user_id
string<uuid>

User UUID to add directly. The user must already exist on Raff (e.g. an existing project-only member). Mutually exclusive with email and api_key_id.

​
api_key_id
string<uuid>

API key UUID to grant account-level access via this membership. Mutually exclusive with email and target_user_id.

​
role_id
string<uuid>

Role UUID. Required.

Response

Member added (or invitation sent)

​
success
boolean
​
data
object
Last modified on May 8, 2026