---
title: "Create User"
method: POST
path: "/v1/user"
---

# Create User

`POST /v1/user`

This API allows you to create a new User.

## Headers

- `authorization` string, required

## Request body

- object
  - `name` string, required — Name of the user
  - `number` string, required — Mobile number of the user.
  - `create_agent` boolean, required — Whether you want to create the user or not.
  - `email` string, required — Email ID of the user.
  - `login_id` string, required — Define login ID for web login. For example: testuser.
  - `user_role` integer, required — Role ID defined for the user, it can be extracted by editing the role on the web panel and copying it from the URL.
  - `password` string, required — Define password for web login.
  - `status` boolean, required
  - `caller_id` integer[], required — Define IDs of the numbers allotted to user. It can be extracted via GET MyNumbers API.
  - `block_web_login` boolean
  - `user_for_cdr` object
    - `type` string — Values - "all" for all agents, "none" for no selection, "agent" for agent selection, "agent_group" for agent group
    - `value` string[] — Pass agent or agent group IDs
  - `login_based_calling` boolean
  - `agent_group` string[]
  - `department` string[]
  - `time_group` string
  - `failover_destination` string[]
  - `enable_calling` boolean — To create logins and make the user workable for calling functionality.

## Response `200`

200

- object

## Other responses

- `400` — 400

---

[API](https://skmtc.net/servetel/apis/servetel-base-api-config.md) · [All operations](https://skmtc.net/servetel/apis/servetel-base-api-config/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/servetel/servetel-base-api-config/versions/d1cb31356d25/schema)
