Skip to main content
A queue object represents a holding area for calls. Calls in a queue are ordered by the time they were enqueued (First-In-First-Out).

​
Creating queues

There are two ways to instantiate a new queue: 1. Using the REST API A queue can be explicitly created by sending a request to the Create New Queue endpoint. 2. Using the <Enqueue> Verb A queue can also be created dynamically during call flow execution. When an <Enqueue> verb is executed inside a TeXML script with a specific queue name, Telnyx checks if a queue with that name already exists. If the queue exists, the call is added to it. If it does not exist, a new queue is automatically created with default settings, and the call is then added.

​
Managing queues

Once a queue is instantiated, it can be managed using the TeXML REST API. Available management actions include: Retrieve a list of all queues associated with your account. This is useful for monitoring active queues and system health. Get detailed information about a specific queue by its Queue SID or name. This returns the current state, including the number of calls currently waiting (current size), the average wait time, and the maximum size configuration. Modify the properties of an existing queue. For example, you can change the maximum number of allowed calls (max size) to prevent overloading the system. View the individual calls currently waiting in a specific queue. This provides details such as the position of each call and how long it has been waiting.