Zoom Phone

Zoom Phone Numbers API

The Phone Numbers API from Zoom Phone — 10 operation(s) for phone numbers.

GitHub OpenAPI
Business capability
Voice & Telephony AE-150.50

Operations 14

Each operation below carries the questions people ask an LLM about it and the instructions they give an agent to run it. Generated by API Evangelist overlay

POST /phone/byoc_numbers Add bring-your-own-carrier numbers to Zoom Phone · Add BYOC phone numbers #
Ask an LLM
“How do I bring my own carrier's phone numbers into Zoom Phone?”
“Can I attach BYOC numbers to a SIP group when I add them under the phone endpoint?”
Tell an agent
Add BYOC numbers {phone_numbers} from carrier {carrier} to Zoom Phone.
Add BYOC numbers {phone_numbers} from {carrier} to site {site_id} via the Zoom Phone endpoint.
GET /phone/numbers List the account's Zoom Phone numbers · List phone numbers #
Ask an LLM
“Which Zoom Phone numbers in our account are still unassigned?”
“Can I filter Zoom Phone numbers by site or by toll-free vs toll number type?”
Tell an agent
List all Zoom Phone numbers on the account.
List {type} Zoom Phone numbers at site {site_id}.
DELETE /phone/numbers Delete unassigned Zoom Phone numbers · Delete unassigned phone numbers #
Ask an LLM
“How do I release Zoom Phone numbers nobody is using?”
“Is there a cap on how many unassigned numbers I can delete in one request?”
Tell an agent destructive · confirm first
Delete unassigned Zoom Phone numbers {phone_numbers}.
Release the unused numbers {phone_numbers} from Zoom Phone, up to 20 at once.
PATCH /phone/numbers/sites/{siteId} Move unassigned numbers to a site · Update a site's unassigned phone numbers #
Ask an LLM
“How do I move spare phone numbers from one site to another?”
“Can I reassign up to 20 unassigned numbers to a different site at once?”
Tell an agent
Move unassigned numbers {phone_numbers} to site {siteId}.
Update site {siteId}'s unassigned phone numbers.
GET /phone/numbers/{phoneNumberId} Get a Zoom Phone number's details · Get a phone number #
Ask an LLM
“Who is a specific Zoom Phone number assigned to?”
“What capabilities and emergency address status does a Zoom Phone number have?”
Tell an agent
Show Zoom Phone number {phoneNumberId}.
Get the assignee and status of Zoom Phone number {phoneNumberId}.
PATCH /phone/numbers/{phoneNumberId} Update a Zoom Phone number · Update a phone number #
Ask an LLM
“How do I set a Zoom Phone number to SMS-only or voice-only capability?”
“Can I change a Zoom Phone number's display name or SIP group?”
Tell an agent
Set the capability of Zoom Phone number {phoneNumberId} to {capability}.
Rename Zoom Phone number {phoneNumberId} to {display_name}.
POST /phone/users/{userId}/phone_numbers Assign a phone number to a user · Assign a phone number to a user #
Ask an LLM
“How do I give a Zoom Phone user a direct phone number?”
“Does a user need Zoom Phone enabled before I can assign them a number?”
Tell an agent
Assign {phone_numbers} to user {userId}.
Give user {userId} a phone number.
DELETE /phone/users/{userId}/phone_numbers/{phoneNumberId} Unassign a phone number from a user · Unassign a phone number #
Ask an LLM
“How do I take a phone number away from a Zoom Phone user?”
“Can I remove a number from someone who's leaving the company?”
Tell an agent destructive · confirm first
Unassign phone number {phoneNumberId} from user {userId}.
Remove number {phoneNumberId} from user {userId}'s phone.
PATCH /number_management/allocation Allocate or unallocate numbers to a product · Allocate/Unallocate phone numbers #
Ask an LLM
“How do I allocate phone numbers with CPL routing to a Zoom product?”
“Must allocated native numbers share the same country and number plan?”
Tell an agent
Allocate numbers {numbers} to {allocated_product}.
Allocate {numbers} to {allocated_product} at site {site_id}.
POST /number_management/byoc_numbers Add BYOC numbers in number management · Add BYOC phone numbers #
Ask an LLM
“Can I add carrier numbers through number management and allocate them to a product?”
“Is PCI Pal supported for BYOC numbers added in number management?”
Tell an agent
Add BYOC numbers {phone_numbers} in number management allocated to {allocated_product}.
Register BYOC numbers {phone_numbers} for {allocated_product} with country {country_iso} in number management.
GET /number_management/numbers List numbers in number management · List phone numbers #
Ask an LLM
“What phone numbers does number management show, filtered by allocated product or status?”
“Can I search number management by keyword or who a number is assigned to?”
Tell an agent
List all numbers in number management.
List number management numbers allocated to {allocated_product} with status {number_status}.
DELETE /number_management/numbers Delete numbers in number management · Delete phone numbers #
Ask an LLM
“How do I delete phone numbers through number management?”
“Can I permanently remove several numbers from the master account?”
Tell an agent destructive · confirm first
Delete numbers {numbers} from number management.
Remove phone numbers {numbers} using number management.
GET /number_management/numbers/{phoneNumberId} Get a number from number management · Get a phone number #
Ask an LLM
“What does number management record about a single phone number?”
“Can I see a number's allocated product and source in number management?”
Tell an agent
Show number management details for number {phoneNumberId}.
Look up number {phoneNumberId} in number management.
PATCH /number_management/numbers/{phoneNumberId} Update a number in number management · Update a phone number #
Ask an LLM
“How do I change a number's caller ID name in number management?”
“Can I confirm an emergency address update while editing a number in number management?”
Tell an agent
Set the caller ID name of number {phoneNumberId} to {caller_id_name} in number management.
Update number management entry {phoneNumberId} with SIP group {sip_group_id}.

Documentation

📖
Documentation
https://developers.zoom.us/docs/api/phone/
📖
APIReference
https://developers.zoom.us/docs/api/phone/
📖
Documentation
https://developers.zoom.us/docs/integrations/oauth/
📖
Documentation
https://developers.zoom.us/docs/api/phone/events/
📖
APIReference
https://developers.zoom.us/docs/api/phone/events/
📖
Documentation
https://developers.zoom.us/docs/api/number-management/
📖
APIReference
https://developers.zoom.us/docs/api/number-management/

Specifications

⚙
OpenAPI
https://artifacts.apis.io/zoom-phone/openapi/zoom-phone-phone-numbers-api-openapi.yml

Other Resources

🔗
PostmanCollection
https://www.postman.com/zoom-developer/zoom-public-workspace/documentation/uba96fr/phone

Work with this as data

Every API here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for apis

7 MCP tools reach this
  • find_apisBrowse and filter every API in the catalog.
  • get_api_artifactsOne API's artifacts, grouped by type.
  • get_openapiThe primary OpenAPI for this API.
  • find_similar_apisAPIs that look like this one.
  • apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
  • resolveTurn a domain, URL or GitHub org into the provider it belongs to.
  • find_cohortsEvery scored population of providers in the catalog.
All 92 tools →

Call it yourself

curl for this page
This API 
curl "https://apis.io/api/v1/apis/zoom-phone:zoom-phone-phone-numbers-api"
All apis 
curl "https://apis.io/api/v1/apis?limit=25"

Calls without X-API-Key need no key. Calls with it need a paid plan — get a key.

Get an API key

Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.

GitHub Google LinkedIn

A second provider on the same verified email joins the account you already have.

OpenAPI Specification

zoom-phone-phone-numbers-api-openapi.yml Raw ↑ 
openapi: 3.2.0
info:
  title: Zoom Phone Phone Numbers API
  version: '2'
  contact:
    name: Zoom Developers
    url: https://developer.zoom.us/
  termsOfService: https://zoom.us/docs/en-us/zoom_api_license_and_tou.html
  description: 'Operations tagged Phone Numbers across 2 of this provider''s published API definitions: zoom-phone-api-openapi.json, zoom-phone-number-management-openapi.json. Each path carries the servers of the definition it was published in.'
servers:
- url: https://api.zoom.us/v2
tags:


# --- truncated at 32 KB (120 KB total) ---
# Full source: https://artifacts.apis.io/zoom-phone/openapi/zoom-phone-phone-numbers-api-openapi.yml