---
title: "Create desk"
method: POST
path: "/{sub_domain}/api/desks"
tags: ["Desks"]
---

# Create desk

`POST /{sub_domain}/api/desks`

## Request

- Base URL: `https://api.commpeak.com/dialer`
- URL: `https://api.commpeak.com/dialer/{sub_domain}/api/desks`
- Auth: API key in header `Authorization`

Creates a desk and assigns users to it.

**Parameters.** `name` (required): the desk name. `userIds` (required): the IDs of the users to assign to the desk.
**Returns.** `{ "userDesk": { ... } }` with the created desk, including its `id`, `name` and `userIds`.
**Example.**

```json
{ "name": "Desk-English", "userIds": [1] }
```

## Path parameters

- `sub_domain` string, required: Dialer Name (subdomain)

## Request body

- CreateUserDeskInput
  - `name` string, required: The name of the desk.
  - `userIds` integer[], nullable: An array of user IDs associated with the desk.

## Response `201`

Successful Response

- UserDeskSingleResponse
  - `userDesk` UserDeskItem, required: A user desk (group of users that share break/state policy).
    - `id` integer, nullable: Desk ID.
    - `name` string, nullable: Desk name.
    - `userIds` integer[], nullable: IDs of the users assigned to the desk.

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/commpeak/apis/commpeak-dialer-api.md) - [All operations](https://skmtc.dev/commpeak/apis/commpeak-dialer-api/llms.txt) - [OpenAPI document](https://skmtc.dev/commpeak/apis/commpeak-dialer-api/revisions/18c5edc07544?raw)