Sign in
Queues

Create queue

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 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.

post/api/relay/rest/queues

Request body

namestring

The name of the queue.

max_sizeinteger

The maximum number of callers allowed in the queue.

Example request

{
  "name": "Name 2",
  "max_size": 600
}

Response

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

idstring uuid required

Universal Unique Identifier.

project_idstring uuid required

Universal Unique Identifier.

friendly_namestring required

The friendly name of the queue.

max_sizeinteger

The maximum number of callers allowed in the queue.

current_sizeinteger

The current number of callers in the queue.

average_wait_timeinteger

The average wait time in seconds.

uristring

The URL of this queue.

date_createdstring date-time

Timestamp when the queue was created.

date_updatedstring date-time

Timestamp when the queue was last updated.

Example response

{
  "friendly_name": "test",
  "max_size": 5,
  "uri": "/api/relay/rest/queues/aae131db-214c-46f5-88b6-92004f8467cf"
}

Changes

No changes found, but 3 of the 137 revisions have a changelog that could not be searched — this endpoint may have changed in one of them.