---
title: "Create user"
method: POST
path: "/v4/accounts/{voip_id}/users"
tags: ["User"]
---

# Create user

`POST /v4/accounts/{voip_id}/users`

## Request

- Base URL: `https://api.phone.com`
- URL: `https://api.phone.com/v4/accounts/{voip_id}/users`
- Auth: HTTP bearer

Adds user for account

## Path parameters

- `voip_id` integer, required

## Request body

- User
  - `user_plan_id` integer: User plan (1 - basic, 2 - plus, 3 - pro)
  - `first_name` string, required: First name
  - `last_name` string, required: Last name
  - `email` string, required: Email
  - `is_admin` boolean: Defines if account is administrative
  - `status` 'new' | 'invite_pending': User status (determines if invitation should be sent automatically)

## Response `201`

Created

- object

## Other responses

- `400`: Bad Request
- `401`: Unauthorized
- `402`: Payment Required
- `403`: Forbidden
- `404`: Not Found
- `409`: Conflict
- `422`: Validation failed
- `429`: Too Many Requests
- `500`: Internal Server Error

---

[API](https://skmtc.dev/phone/apis/phoenix-api-by-phone-com.md) · [All operations](https://skmtc.dev/phone/apis/phoenix-api-by-phone-com/llms.txt) · [OpenAPI document](https://skmtc.dev/phone/apis/phoenix-api-by-phone-com/revisions/a6274ad4319c?raw)