Add users to a client account

• A valid API key for the client account — see Obtain API credentials
• The client must already exist — see Onboard a new client

Send POST /v1/users with the user details. Authenticate using the client's API key so the user is associated with the correct client.

curl -X POST \
  https://api.dev.paradisegateway.net/v1/users \
  -H "Content-Type: application/json" \
  -H "APIKEY: CLIENT-API-KEY" \
  -d '{
    "first_name": "Jane",
    "last_name": "Smith",
    "email": "jane.smith@example.com",
    "phone": "+15559876543",
    "time_zone": "America/Chicago"
  }'

A 201 Created response returns the new user.

{
  "id": "USER-5NvxCyMmeKxIv8jz39b4urQb",
  "object": "user",
  "first_name": "Jane",
  "last_name": "Smith",
  "email": "jane.smith@example.com",
  "phone": "+15559876543",
  "time_zone": "America/Chicago",
  "is_mfa_active": false,
  "is_active": true,
  "is_locked": false,
  "correlation_id": "c3d4e5f6-a7b8-9012-cdef-123456789abc"
}

To see all users on the client account, send GET /v1/users.

curl https://api.dev.paradisegateway.net/v1/users \
  -H "APIKEY: CLIENT-API-KEY"

The response is an array of user objects associated with the client whose API key you used.

• Update a user profile — modify name, email, or phone
• Reset a user password
• Enable MFA
• About users and roles