Sample - Twilio API
POST/2010-04-01/Accounts/{AccountSid}/Queues.json

Create a queue

Creates a queue for an account. Supply FriendlyName to identify the queue, and optionally provide MaxSize to set its call capacity. The response returns the created queue with its generated SID and initial queue metrics.

  • RetriesRetries up to 2×, 500ms backoff, 30s timeout.

1 parameter · 2 body fields
AccountSidstringrequired
The account SID that will own the new queue. Must be a 34-character value matching `^AC[0-9a-fA-F]{32}$`.

Queue creation properties. Provide a descriptive FriendlyName; MaxSize is optional.

FriendlyNamestringrequired
A descriptive string that you created to describe this resource. It can be up to 64 characters long.
MaxSizeintegeroptional
The maximum number of calls allowed to be in the queue. The default is 1000. The maximum is 5000.

1 status code
201Returns the created queue object with its generated SID, account SID, friendly name, initial current size, maximum size, average wait time, resource URI, and timestamps.
date_updatedstringoptional
The date and time in GMT that this resource was last updated, specified in [RFC 2822](https://www.ietf.org/rfc/rfc2822.txt) format.
current_sizeintegeroptional
The number of calls currently in the queue.
Default:0
friendly_namestringoptional
A string that you assigned to describe this resource.
uristringoptional
The URI of this resource, relative to `https://api.twilio.com`.
account_sidstringoptional
The SID of the [Account](https://www.twilio.com/docs/iam/api/account) that created this Queue resource.
average_wait_timeintegeroptional
The average wait time in seconds of the members in this queue. This is calculated at the time of the request.
Default:0
sidstringoptional
The unique string that that we created to identify this Queue resource.
date_createdstringoptional
The date and time in GMT that this resource was created specified in [RFC 2822](https://www.ietf.org/rfc/rfc2822.txt) format.
max_sizeintegeroptional
The maximum number of calls that can be in the queue. The default is 1000 and the maximum is 5000.
Default:0

Error handling

AccountSid must be a 34-character account SID matching the AC prefix format. FriendlyName is required and can contain up to 64 characters; MaxSize cannot exceed 5000 and defaults to 1000 when omitted.