---
title: "Create User"
method: POST
path: "/users"
tags: ["User"]
---

# Create User

`POST /users`

### Add User

This endpoint allows the client to add a new user by sending a POST request to the specified URL.

#### Request Body

- `username` (string): The username of the user.
    
- `password` (string): The password for the user account.
    
- `email` (string): The email address of the user.
    
- `sip_option` (string): The SIP option for the user.
    
- `is_active` (string): Indicates whether the user account is active.
    
- `reset_password` (string): Indicates whether the user should reset their password.
    
- `sip_uri` (string): The SIP URI for the user.
    
- `use_extended_ip_acl` (string): Indicates the usage of extended IP ACL.
    
- `user_route_caller_id` (string): The caller ID for user routing.
    
- `member_all_desks` (string): Indicates membership to all desks.
    
- `desks` (array): An array of desks associated with the user.
    
- `roles` (array): An array of roles assigned to the user.

## Request body

- object
  - `is_active` string
  - `kerb_username` unknown
  - `password` string
  - `reset_password` string
  - `sip_option` string
  - `sip_uri` unknown
  - `use_extended_ip_acl` string
  - `username` string

## Response `201`

Successful operation

- object
  - `users` object[]
    - `auto_dial` string
    - `default_language` unknown
    - `desks` object
      - `1` string
    - `email` string
    - `first_name` string
    - `id` string
    - `is_active` string
    - `is_deleted` string
    - `last_name` string
    - `max_concurrent_sessions` string
    - `max_session_time` string
    - `member_all_desks` string
    - `registration_password` string
    - `roles` object
      - `1` string
    - `sip_uri` unknown
    - `timezone_id` unknown
    - `twofa_type` string
    - `use_extended_ip_acl` string
    - `use_webrtc` string
    - `user_region` string
    - `username` string
    - `virtual_extension` unknown

## Other responses

- `404` — Error 1 / Error 2 / Error 3

---

[API](https://skmtc.net/commpeak/apis/dialer-api-v2-0-1.md) · [All operations](https://skmtc.net/commpeak/apis/dialer-api-v2-0-1/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/commpeak/dialer-api-v2-0-1/revisions/eacecf960bb6/schema)