Sign in
Queues

Create a Queue

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

Permissions

The API token must include the following scopes: Voice.

post/Accounts/{AccountSid}/Queues

Path parameters

AccountSidstring uuid required

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

Response

Response returned when a queue is successfully created.

sidstring uuid required

The unique identifier for the queue.

account_sidstring uuid required

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

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

{
  "sid": "b3877c40-da60-4998-90ad-b792e98472qu",
  "account_sid": "b3877c40-da60-4998-90ad-b792e98472af",
  "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"
}

Changes