Create User

curl --request POST \ --url https://app.rizzdial.com/api/users \ --header 'Authorization: Bearer <token>' \ --header 'Content-Type: application/json' \ --data '{ "name": "Ada Lovelace", "email": "ada@example.com", "role_id": 12, "password": "secret12" }'

Create User#

Creates a company user and sends a welcome email. Requires add-users. role_id must be from User Helpers or User Roles.

Authorizationstringheaderrequired

Bearer token in the format: Bearer {access_token}

namestringbodyrequired

Full name. Max 255 characters

emailstringbodyrequired

Sign-in email. Must be unique in the company

role_idintegerbodyrequired

Role id from User Helpers or User Roles

passwordstringbodyrequired

Password. Minimum 6 characters

statusstringbody

Pending (default), Active, Inactive, or Suspended

dialerstringbody

No (default) or Both

use_balancestringbody

Company (default) or User

pay_for_seatsstringbody

No (default) or Rizzler

use_company_seatstringbody

No (default) or Yes. Ignored when pay_for_seats is Rizzler

local_presencestringbody

No (default) or Yes

phone_numberstringbody

Optional personal phone. Max 30 characters

ext_phonearraybody

Phone number ids from User Helpers. A number already assigned to another user is rejected

area_codesarraybody

Area codes from User Helpers. Used only when local_presence is Yes

curl --request POST \
  --url https://app.rizzdial.com/api/users \
  --header 'Authorization: Bearer {{bearer_token}}' \
  --header 'Content-Type: application/json' \
  --data '{"name":"Ada Lovelace","email":"ada@example.com","role_id":12,"password":"secret12"}'

dataobject

The created user, including role_id, dialer fields, ext_phone_ids, and area_codes

POST /api/users/create is the same endpoint.