---
title: "Create queue"
method: POST
path: "/api/relay/rest/queues"
tags: ["Queues"]
---

# Create queue

`POST /api/relay/rest/queues`

Creates a voice call queue in the project for calls that need to wait for later handling. Queue names must be unique among active queues; a deleted queue's name can be reused. The call workflow is responsible for placing callers into the queue. Use Compatibility [Create queue](/docs/compatibility-api/rest/queues/create-queue) for form-encoded requests.

#### Permissions

The API token used to authenticate must have the following scope(s) enabled to make a successful request: _Voice_.

[Learn more about API scopes](/docs/platform/your-signalwire-api-space).

## Request body

- CreateQueueRequest — Request body for creating a queue.
  - `name` string — The name of the queue.
  - `max_size` integer — The maximum number of callers allowed in the queue.

## Response `201`

The request has succeeded and a new resource has been created as a result.

- QueueResponse — Response containing a single queue.
  - `id` string, uuid, required — Universal Unique Identifier.
  - `project_id` string, uuid, required — Universal Unique Identifier.
  - `friendly_name` string, required — The friendly name of the queue.
  - `max_size` integer — The maximum number of callers allowed in the queue.
  - `current_size` integer — The current number of callers in the queue.
  - `average_wait_time` integer — The average wait time in seconds.
  - `uri` string — The URL of this queue.
  - `date_created` string, date-time — Timestamp when the queue was created.
  - `date_updated` string, date-time — Timestamp when the queue was last updated.

## Other responses

- `401` — Access is unauthorized.
- `422` — The request failed validation. See errors for details.
- `500` — An internal server error occurred.

---

[API](https://skmtc.dev/signalwire/apis/signalwire-rest-api.md) · [All operations](https://skmtc.dev/signalwire/apis/signalwire-rest-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/signalwire/signalwire-rest-api/revisions/792d5b8e2970/schema)