Create/Add user

Creates a new user and sends an invitation email if the user does not exist. Adds the new or existing user to the current account. If the user already exists and is already a member of the account, an error is returned

• If the user already exists but isn’t a member of the account, they are added without creating a new user record
• The user won’t be able to access the account until they complete the activation process by setting their password
• For security, new users must set their own password via the activation link
• The function schedules cleanup tasks to remove unactivated user accounts after a certain period of time (48 hours)

POST /accounts/users

Create/Add user

cURL

curl --request POST \
  --url https://api.quiva.ai/accounts/users \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "first_name": "Jane",
  "last_name": "Smith",
  "email": "[e-mail]",
  "role": "developer"
}
'

200

{
  "message": "<string>"
}

Authorizations

bearerAuthapiKeyAuth

Authorization · string · header · required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Body

application/json

first_name · string · required

First name

last_name · string · required

Last name

email · string<email> · required

Email address

role · enum<string> · required

Role

Available options: admin, developer, monitor, billing

Response

200

application/json

User created successfully

message · string