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.