Skip to main content
The Power Dialer API lets you manage a user’s queue — append numbers, configure it, clear or reset it, and read its state. Each user has at most one active Power Dialer queue at a time. The queue is created implicitly the first time you append numbers or call reset.

​
Required scope

All endpoints require the DIALING_QUEUE_READ_WRITE scope on your API key.

​
Assigning a queue to a teammate

Every endpoint accepts user_id or email to act on a teammate’s queue instead of the API key owner’s. The wire location depends on the endpoint (query string vs JSON body) — see each endpoint’s “Targeting a teammate’s queue” section for specifics. Rules that apply to every endpoint:
  • user_id wins when both user_id and email are provided.
  • The teammate must belong to the same team as the API key owner.
  • If the resolved user doesn’t exist or isn’t a teammate, the API returns 404 ASSIGNEE_NOT_FOUND. The same error covers both cases on purpose, so API consumers cannot enumerate users.
  • When you append to a teammate who has no current queue, one is created with the API key owner as creator_id and the teammate as assignee_id.

​
Endpoints

Get current queue

Retrieve the queue assigned to a user (yourself or a teammate)

Upsert queue config

Update the queue name, voicemail handling, or do-not-disturb

Append numbers

Add phone numbers (and optional contact metadata) to a queue

Clear numbers

Remove specific numbers, a position, or every unassigned entry

Reset queue

Discard the current queue and start a fresh one