Level up your Twilio API skills in TwilioQuest, an educational game for Mac, Windows, and Linux. Download Now

Menu

Expand
Rate this page:

Thanks for rating this page!

We are always striving to improve our documentation quality, and your feedback is valuable to us. How could this documentation serve you better?

Queue Resource

The Queue resource describes a call queue that contains individual calls, which are described by the queue's Member resources. Your account can have more than one call queue. Each queue can be retreived by it's sid directly using fetch. Alternately, you can read the list of Queues and filter by friendly_name or any other property you prefer.

Call queues are created when you enqueue a call to a queue that doesn't exist and when you call the create action.

For information about enqueing calls to a call queue, see Queueing Calls.

Queue properties

Names in Python format
account_sid
sid<AC> Not PII

The SID of the Account that created this Queue resource.

average_wait_time
integer Not PII

The average wait time in seconds of the members in this queue. This is calculated at the time of the request.

current_size
integer Not PII

The number of calls currently in the queue.

date_created
date_time<rfc2822> Not PII

The date and time in GMT that this resource was created specified in RFC 2822 format.

date_updated
date_time<rfc2822> Not PII

The date and time in GMT that this resource was last updated, specified in RFC 2822 format.

friendly_name
string Not PII

A string that you assigned to describe this resource.

max_size
integer Not PII

The maximum number of calls that can be in the queue. The default is 100 and the maximum is 5000.

sid
sid<QU> Not PII

The unique string that that we created to identify this Queue resource.

uri
uri Not PII

The URI of this resource, relative to https://api.twilio.com.

Create a Queue resource

post
https://api.twilio.com/2010-04-01/Accounts/{AccountSid}/Queues.json
Parameters
Names in None format
max_size
Optional
post integer Not PII

The maximum number of calls allowed to be in the queue. The default is 100. The maximum is 5000.

friendly_name
Required
post string Not PII

A descriptive string that you created to describe this resource. It can be up to 64 characters long.

account_sid
Required
post sid<AC> Not PII

The SID of the Account that will create the resource.

Example
        
        
        
        

        Fetch a Queue resource

        get
        https://api.twilio.com/2010-04-01/Accounts/{AccountSid}/Queues/{Sid}.json
        Parameters
        Names in None format
        account_sid
        Required
        get sid<AC> Not PII

        The SID of the Account that created the Queue resource(s) to fetch.

        sid
        Required
        get sid<QU> Not PII

        The Twilio-provided string that uniquely identifies the Queue resource to fetch

        Example
              
              
              
              

              Read multiple Queue resources

              get
              https://api.twilio.com/2010-04-01/Accounts/{AccountSid}/Queues.json
              Parameters
              Names in None format
              account_sid
              Required
              get sid<AC> Not PII

              The unique id of the Account responsible for creating this Call.

              Example
                    
                    
                    
                    

                    Update a Queue resource

                    post
                    https://api.twilio.com/2010-04-01/Accounts/{AccountSid}/Queues/{Sid}.json
                    Parameters
                    Names in None format
                    account_sid
                    Required
                    post sid<AC> Not PII

                    The SID of the Account that created the Queue resource(s) to update.

                    sid
                    Required
                    post sid<QU> Not PII

                    The Twilio-provided string that uniquely identifies the Queue resource to update

                    friendly_name
                    Optional
                    post string Not PII

                    A descriptive string that you created to describe this resource. It can be up to 64 characters long.

                    max_size
                    Optional
                    post integer Not PII

                    The maximum number of calls allowed to be in the queue. The default is 100. The maximum is 5000.

                    Example
                          
                          
                          
                          

                          Delete a Queue resource

                          delete
                          https://api.twilio.com/2010-04-01/Accounts/{AccountSid}/Queues/{Sid}.json
                          Parameters
                          Names in None format
                          account_sid
                          Required
                          delete sid<AC> Not PII

                          The SID of the Account that created the Queue resource(s) to delete.

                          sid
                          Required
                          delete sid<QU> Not PII

                          The Twilio-provided string that uniquely identifies the Queue resource to delete

                          Example
                                
                                
                                
                                
                                Rate this page:

                                Need some help?

                                We all do sometimes; code is hard. Get help now from our support team, or lean on the wisdom of the crowd browsing the Twilio tag on Stack Overflow.