Creates a new user and returns the created record.

When to use. Add a user to your account. If a user with the same username already exists, that existing user is returned and no new user is created.

Required fields. username, email and sip_option.

Notes. If you omit password, a temporary password is generated for the user. When sip_option is set to Custom URI, sip_uri is required. You can also assign roles and desks by passing their IDs. See the request schema for the full list of accepted fields.

Returns. 201 Created with { "users": [ { ... } ] }.

Example.

{
  "username": "jsmith",
  "email": "[email protected]",
  "sip_option": 0
}