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"  }'
{  "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"  }}