v36

latestOpenAPI 3.1.0raw.githubusercontent.com2026-05-1279125449.6 KB

Queues

Create a Queue

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.

post/Accounts/{AccountSid}/Queues

Path parameters

AccountSidstring uuid required

Universal Unique Identifier.

The unique identifier for the account this Queue is associated with.

Response

Response returned when a queue is successfully created.

sidstring uuid required

Universal Unique Identifier.

account_sidstring uuid required

Universal Unique Identifier.

friendly_namestring required

A description that distinguishes a queue.

max_sizeinteger nullable required

The maximum number of calls that are allowed to wait in a queue. Null if no limit is set.

current_sizeinteger required

The number of calls currently waiting in the queue.

average_wait_timeinteger required

The average wait time, in seconds, of callers in a queue.

date_createdstring required

The date and time, in RFC 2822 format, the Queue was created.

date_updatedstring required

The date and time, in RFC 2822 format, the Queue was updated.

api_versionstring required

The version of the SignalWire API.

uristring required

The URI of this resource, relative to the API base URL.

Example response

{
  "friendly_name": "Queue1",
  "max_size": 100,
  "date_created": "Wed, 26 Sep 2018 18:00:00 +0000",
  "date_updated": "Thu, 27 Sep 2018 19:00:00 +0000",
  "api_version": "2010-04-01",
  "uri": "/api/laml/2010-04-01/Accounts/b3877c40-da60-4998-90ad-b792e98472af/Queues/b3877c40-da60-4998-90ad-b792e98472qu.json"
}