Skip to main content

CreateUser creates a new user in the organization.

POST 

/api/v1/auth/users

Creates user and sends invitation email.

Parameters​

  • first_name: Required, user's first name
  • last_name: Required, user's last name
  • email: Required, user email (must be unique)
  • phone_number: Optional, user phone
  • role_ids: Optional, roles to assign
  • create_agent: Optional, create unified agent
  • agent_type: Optional, agent type if creating agent
  • channels: Optional, override agent channels

Side Effects​

  • Sends invitation email
  • Creates unified agent if requested

Errors​

  • ALREADY_EXISTS: Email already in use
  • PERMISSION_DENIED: Caller lacks users:write permission

Request​

Responses​

A successful response.