Introduction
Using Zoom APIs
Pagination
Error Definitions
Rate Limits
Testing Zoom APIs
Account Events
App Events
Chat Message Events
Chat Channel Events
Chatbot Events
Meeting Events
Phone Events
Recording Events
TSP Events
User Events
Webinar Events
Zoom Room Events
Data Compliance
post

/phone/call_queues

Call queues allow you to route incoming calls to a group of users. For instance, you can use call queues to route calls to various departments in your organization such as sales, engineering, billing, customer service etc.
Use this API to create a call queue.
You can add phone users or common area phones to call queues.

Prerequisites:

  • Pro, Business, or Education account
  • Account owner or admin permissions
  • Zoom Phone license
    Scopes: phone:write:admin

Rate Limit Label: Light

Authorization

oauth2 - authorizationCode

Request Body

1 Example
Schema
object
site_id
string

Required only if multiple sites have been enabled. This can be retrieved from the List Phone Sites API.

required
name
string

Name of the Call Queue.

2 validations + required
extension_number
integer

Phone extension number for the site.

If a site code has been assigned to the site, provide the short extension number instead of the original extension number…

description
string

Description for the Call Queue.

1 validation
members
object

A list of one or more phone users to be included in the call queue. Provide either users or common area phone(s). Provide at least one user in the users object.

Responses

HTTP Status Code: 201 Created
Call Queue created successfully.

1 Example
Schema
object
id
string

Unique Identifier of the Call Queue.

name
string

Name of the Call Queue.

extension_number
integer

Extension number assigned for the Call Queue.

status
string

Status of the Call Queue.
active: Call queue is enabled and active.
inactive: Call queue is inactive. Inactive call queues cannot be called but will retain its settings and appear in the Call Queues page.

Send a Test Request

Send requests directly from the browser (CORS must be enabled)
$$.env
1 variable not set
oauth_access_token