---
title: "Create a Queue"
method: POST
path: "/Accounts/{AccountSid}/Queues"
tags: ["Queues"]
---

# Create a Queue

`POST /Accounts/{AccountSid}/Queues`

Create a call queue. Queue names must be unique among active queues within an account and can only contain alphanumeric characters and underscores. Deleted queue names can be reused.

#### 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](/platform/dashboard/getting-started/your-signalwire-api-space#api-token-scopes).

## Path parameters

- `AccountSid` string, uuid, required

## Response `201`

Response returned when a queue is successfully created.

- Queue — Queue model.
  - `sid` string, uuid, required — The unique identifier for the queue.
  - `account_sid` string, uuid, required — The unique identifier for the account this Queue is associated with.
  - `friendly_name` string, required — A description that distinguishes a queue.
  - `max_size` integer, nullable, required — The maximum number of calls that are allowed to wait in a queue. Null if no limit is set.
  - `current_size` integer, required — The number of calls currently waiting in the queue.
  - `average_wait_time` integer, required — The average wait time, in seconds, of callers in a queue.
  - `date_created` string, required — The date and time, in RFC 2822 format, the Queue was created.
  - `date_updated` string, required — The date and time, in RFC 2822 format, the Queue was updated.
  - `api_version` string, required — The version of the SignalWire API.
  - `uri` string, required — The URI of this resource, relative to the API base URL.

## Other responses

- `400` — The request was invalid or cannot be processed. Check the error details for more information.
- `401` — Authentication failed. Please verify your credentials and try again.
- `422` — The request could not be processed due to validation errors. Check the error details for more information.

## Changes

- **2026-01-19** `d5fbaaddfa3e` — 4 breaking, 2 warning, 2 info
  - the `FriendlyName` request property's minLength was increased from `0` to `1`
  - added the pattern `^\w+$` to the request property `FriendlyName`
  - the `MaxSize` request property type/format changed from `string`/`` to `integer`/`int32`
  - removed the success response with the status `200`
  - …4 more
- **2026-01-15** `50dab84bcf02` — 1 breaking
  - request body became required
- **2026-01-15** `479ede876c89` — 1 info
  - request body became optional
- **2026-01-15** `07f73f74a61d` — 1 breaking, 1 info
  - removed the media type `application/json` from the request body
  - added the media type `application/x-www-form-urlencoded` to the request body
- **2026-01-15** `3c88f14db21e` — 3 breaking, 3 info
  - request body became required
  - removed the media type `application/x-www-form-urlencoded` from the request body
  - the `average_wait_time` response's property type/format changed from `string`/`uuid` to `string`/`` for status `200`
  - added the media type `application/json` to the request body
  - …2 more

[Change history](https://skmtc.dev/signalwire/apis/compatibility-api/changes/Accounts/:AccountSid/Queues/post.md)

---

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