API ReferenceAccount users

Create account user

Create a new user in the specified account.

POST
/v1/users

Authorization

authorization
AuthorizationBearer <token>

In: header

Request Body

application/json

User details

TypeScript Definitions

Use the request body type in TypeScript.

Request schema for creating a user in an account

Response Body

application/json

application/json

application/json

curl -X POST "https://example.com/v1/users" \  -H "Content-Type: application/json" \  -d '{    "add_provider": false,    "display_name": "Dr. John Doe",    "email": "john.doe@example.com",    "first_name": "John",    "last_name": "Doe",    "notify": false,    "passive": false,    "role_ids": [      "role_123456789012"    ],    "time_zone": "America/Chicago"  }'
{  "data": {    "object": "account_user",    "passive": false,    "roles": [      {        "denied_permissions": [          "appointments.own.cancel",          "appointments.own.reschedule"        ],        "id": "role_123456789012",        "name": "Staff",        "object": "role",        "permissions": [          "accounts.view",          "appointments.own.*",          "blocks.*",          "booking_intents.*",          "clients.*",          "integrations.own.*",          "providers.own.view",          "providers.own.update"        ],        "type": "staff"      }    ],    "user": {      "created_at": "2025-03-15T13:01:08Z",      "email": "avery@tendermedical.com",      "first_name": "Avery",      "id": "user_d025a96ac0c6",      "last_name": "Evans",      "object": "user",      "updated_at": "2025-03-15T13:01:08Z"    }  }}