Zoom Phone

Zoom Phone Devices API

The Phone Devices API from Zoom Phone — 8 operation(s) for phone devices.

GitHub OpenAPI
Business capability
IT Infrastructure Management BC-600.50

Operations 11

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

GET /phone/devices List desk phone devices · List devices #
Ask an LLM
“Which desk phones on our account are still unassigned?”
“Can I filter desk phones by site, assignee type or whether their location is known?”
Tell an agent
List {type} desk phone devices.
List {type} desk phones at site {site_id} matching {keyword}.
POST /phone/devices Add a desk phone · Add a device #
Ask an LLM
“How do I register a new desk phone by its MAC address?”
“Can I add a desk phone and assign it to a user or common area in one step?”
Tell an agent
Add desk phone {display_name} with MAC address {mac_address} of type {type}.
Add {type} phone {mac_address} named {display_name} and assign it to {assigned_to}.
POST /phone/devices/sync Resync zero-touch desk phones · Sync deskphones #
Ask an LLM
“How do I push a resync to all our zero-touch provisioned desk phones?”
“How often am I allowed to resync desk phones for a site?”
Tell an agent
Resync all online desk phones at the {level} level.
Resync desk phones at the {level} level for site {site_id}.
GET /phone/devices/{deviceId} Get a desk phone's details · Get device details #
Ask an LLM
“What model, status and assignee does a specific desk phone have?”
“Can I check which provision template a desk phone uses?”
Tell an agent
Show desk phone {deviceId}.
Get the details of device {deviceId}.
DELETE /phone/devices/{deviceId} Remove a desk phone or ATA · Delete a device #
Ask an LLM
“How do I remove a desk phone or analog adapter from Zoom Phone?”
“What happens to a retired desk phone when I delete it from system management?”
Tell an agent destructive · confirm first
Delete desk phone {deviceId}.
Remove ATA device {deviceId} from Zoom Phone.
PATCH /phone/devices/{deviceId} Update a desk phone · Update a device #
Ask an LLM
“How do I rename a desk phone?”
“Can I reassign a desk phone or change its provision template in a general update?”
Tell an agent
Rename desk phone {deviceId} to {display_name}.
Update desk phone {deviceId} so it is assigned to {assigned_to}.
POST /phone/devices/{deviceId}/extensions Assign users or common areas to a desk phone · Assign an entity to a device #
Ask an LLM
“How do I share one desk phone between several extensions?”
“Can I add a user's extension to a desk phone that's already set up?”
Tell an agent
Assign extensions {assignee_extension_ids} to desk phone {deviceId}.
Add extension {assignee_extension_ids} as an assignee of device {deviceId}.
DELETE /phone/devices/{deviceId}/extensions/{extensionId} Unassign an extension from a desk phone · Unassign an entity from the device #
Ask an LLM
“How do I take one user off a shared desk phone?”
“Can I unassign a single assignee from a device and leave the rest?”
Tell an agent destructive · confirm first
Unassign extension {extensionId} from desk phone {deviceId}.
Remove assignee {extensionId} from device {deviceId}.
PUT /phone/devices/{deviceId}/provision_templates Set or clear a desk phone's provision template · Update provision template of a device #
Ask an LLM
“How do I apply a provision template to a desk phone?”
“Can I remove the provision template from a device?”
Tell an agent
Apply provision template {provision_template_id} to desk phone {deviceId}.
Clear the provision template on device {deviceId}.
POST /phone/devices/{deviceId}/reboot Reboot a desk phone · Reboot a desk phone #
Ask an LLM
“How do I remotely restart a frozen desk phone?”
“Can I reboot only zero-touch or assisted-provisioning phones remotely?”
Tell an agent
Reboot desk phone {deviceId}.
Restart device {deviceId} remotely.
GET /phone/smartphones List smartphones configured with Zoom Phone · List Smartphones #
Ask an LLM
“Which smartphones are configured with Zoom Phone on our account?”
“Can I search smartphones by site or keyword?”
Tell an agent
List all smartphones configured with Zoom Phone.
List Zoom Phone smartphones at site {site_id} matching {keyword}.

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://raw.githubusercontent.com/api-evangelist/zoom-phone/refs/heads/main/openapi/zoom-phone-phone-devices-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-devices-api"
All apis 
curl "https://apis.io/api/v1/apis?limit=25"

Discovery needs no key. Ratings and market analysis are Pro.

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-devices-api-openapi.yml Raw ↑ 
openapi: 3.2.0
info:
  title: Phone Devices API
  description: 'You can access information from Zoom with Zoom Phone APIs to build private services or public applications on the Zoom App Marketplace.


    To learn how to get your credentials and create private or public applications, see Zoom APIs use OAuth 2.0 authorization.


    All endpoints are available through `https` at `api.zoom.us/v2/`. For instance, `https://api.zoom.us/v2/users/` returns all users on an account. You''ll receive a `403` error message if you have not set up Zoom Phone.'
  termsOfService: https://zoom.us/docs/en-us/zoom_api_license_and_tou.html
  contact:
    name: Zoom Developers
    url: https://developer.zoom.us/
  version: '2'
servers:
- url: https://api.zoom.us/v2
tags:


# --- truncated at 32 KB (82 KB total) ---
# Full source: https://raw.githubusercontent.com/api-evangelist/zoom-phone/refs/heads/main/openapi/zoom-phone-phone-devices-api-openapi.yml