Queues

Create and manage TeXML queues to handle waiting callers.

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.

• Fetch a Queue

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.

• Update a Queue

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.

• Delete a Queue

Remove a queue from your account.