Zoom Phone
Zoom Phone connector for SMS/MMS messaging, SMS campaigns, phone users, phone numbers, call logs, call history, recordings, voicemails, external contacts, sites, and call queues.
Categories: Telephony, Communication
📝 Beta: This connector is in beta. It follows the service's documented API but has not yet been fully tested against the live service, so some tools may behave differently than described.
What you can ask
- List missed calls for user
jane.doe@example.comfrom the last 24 hours - Send an SMS from the main line to
+1 415 555 0134 - List yesterday's call recordings for user
jane.doe@example.com
Set up
Zoom Phone needs an OAuth application from your organization before anyone can connect. An organization admin completes these steps once.
- Go to Organization > Connectors and find Zoom Phone. Click Enable, and choose which tools to allow.
- Create an OAuth application in the Zoom Phone developer portal.
- Add the Redirect URI shown in the connector settings to the application.
- Copy the application's Client ID and Client Secret into the connector, then save it.
- Each member connects their own account the first time they use it.
⚠️ Warning: Do not enter your Devs.ai or Zoom Phone login email or password in the OAuth application fields.
To use one account for the whole organization, turn on Share one connection with everyone. Every member's agents then act as that account, with exactly the access it has.
OAuth scopes used by these tools (42)
Grant the scopes for the tools you plan to allow.
phone:delete:external_contact:adminphone:delete:recording:adminphone:delete:sms_campaign_phone_number:adminphone:delete:user_phone_number:adminphone:delete:voicemail:adminphone:read:account_setting:adminphone:read:call_history:adminphone:read:call_log:adminphone:read:call_queue:adminphone:read:external_contact:adminphone:read:list_call_history:adminphone:read:list_call_logs:adminphone:read:list_call_queues:adminphone:read:list_external_contacts:adminphone:read:list_phone_numbers:adminphone:read:list_recordings:adminphone:read:list_sites:adminphone:read:list_sms_campaign_opt_status:adminphone:read:list_sms_campaigns:adminphone:read:list_sms_sessions:adminphone:read:list_users:adminphone:read:list_voicemails:adminphone:read:phone_number:adminphone:read:recording:adminphone:read:setting:adminphone:read:site:adminphone:read:sms_campaign:adminphone:read:sms_message:adminphone:read:sms_session:adminphone:read:user:adminphone:read:user_setting:adminphone:read:voicemail:adminphone:update:external_contact:adminphone:update:phone_number:adminphone:update:recording:adminphone:update:sms_campaign_opt_status:adminphone:update:user:adminphone:update:voicemail:adminphone:write:external_contact:adminphone:write:sms_campaign_phone_number:adminphone:write:sms_message:adminphone:write:user_phone_number:admin
Tools
Zoom Phone offers 54 tools. Admins choose which ones agents can use. See Tool permission groups.
Read (39)
View and search information without changing it.
| Tool | What it does |
|---|---|
download_sms_attachment | Download an SMS/MMS attachment through the file service. |
get_account_settings | Get the account's Zoom Phone feature settings (recording, voicemail, SMS, outbound SMS, call handling, and more). |
get_call_history | Get full details of one call-history record (newer format), including the call_path legs and call_elements segments. |
get_call_log | Get full details of one call log (legacy format), including the per-leg log_details path and recording/voicemail flags. |
get_call_log_recordings | Get the recording for a specific call by its call log ID, with caller/callee, duration, and the audio download_url. |
get_call_queue | Get full details of one call queue: members (users and common areas), assigned phone numbers, policy, timezone, and languages. |
get_campaign_number_opt_status | List the opt-in/opt-out status of consumer numbers against Zoom Phone numbers for a 10DLC SMS campaign. |
get_consent_opt_status | List the opt-in/opt-out status of consumer numbers under an SMS consent record. |
get_external_contact | Get full details of one external contact: name, email, description, phone numbers, and extension. |
get_phone_number | Get full details of one phone number: its E.164 number, type, status, capabilities, assignee, site, carrier, and emergency address. |
get_phone_settings | Get account-level Zoom Phone settings: bring-your-own-carrier (BYOC), country, multi-site enablement, and the billing account. |
get_site | Get full details of one Zoom Phone site: name, site code, country, and main auto receptionist. |
get_sms_campaign | Get full details of one 10DLC SMS campaign: status, brand, use case, sample messages, and the phone numbers assigned to it. |
get_sms_message | Get a single SMS/MMS message by its ID within a session. |
get_sms_session | Get the message history of one SMS/MMS session (conversation), newest or oldest first. |
get_user | Get a Zoom Phone user's full profile: assigned phone numbers, extension, site, calling plans, and the per-feature policy object. |
get_user_call_handling | Get a user's call-handling settings: business, closed, and holiday hours plus the call-forwarding rules that apply in each. |
get_user_campaign_opt_status | List a user's consumer-number opt-in/opt-out statuses across SMS campaigns. |
get_user_settings | Get a user's phone profile settings: outbound caller IDs, devices, delegation, business hours, and more. |
get_voicemail | Get full details of one voicemail: caller/callee, duration, read status, audio download_url, and the transcription when available. |
list_account_sms_sessions | List SMS/MMS conversation sessions across the account, newest activity first. |
list_call_history | List the account's call history (newer format), each record with caller/callee, direction, duration, result, and times. |
list_call_logs | List the account's call logs (legacy format), each with caller/callee, direction, duration, result, and a recording_id when recorded. |
list_call_queues | List call queues (ring groups that route inbound calls to members), each with its id, name, extension, assigned phone numbers, status, and site. |
list_external_contacts | List external contacts (non-Zoom people reachable by call or SMS), each with name, email, phone numbers, and external_contact_id. |
list_phone_numbers | List phone numbers on the account, each with its id, E.164 number, type, status, capabilities, and current assignee. |
list_recordings | List the account's call recordings, each with caller/callee, duration, a download_url for the audio, and a transcript_download_url when available. |
list_sites | List Zoom Phone sites (locations that group users and numbers), each with its id, name, site code, and country. |
list_sms_campaigns | List the account's 10DLC SMS campaigns (US A2P messaging registrations) with their status and brand. |
list_user_call_logs | List one user's call logs, each with caller/callee, direction, duration, result, forwarding, and recording/voicemail flags. |
list_user_recordings | List one user's call recordings, each with caller/callee, duration, and download URLs for audio and transcript. |
list_user_sms_sessions | List SMS/MMS conversation sessions owned by a specific phone user, newest activity first. |
list_user_voicemails | List one user's voicemails, each with caller/callee, duration, read status, and an audio download_url. |
list_users | List Zoom Phone users, each with their id, extension, assigned phone numbers, and site. |
list_voicemails | List the account's voicemails, each with caller/callee, duration, read status, and an audio download_url. |
read_sms_attachment_text | Extract readable text from a PDF, DOCX, spreadsheet, or text attachment on an SMS/MMS message. |
sync_sms_session | Sync (full, incremental, or backward) the messages of one SMS session, returning a sync_token to fetch only changes on the next call. |
sync_user_sms_sessions | Sync (full, incremental, or backward) a user's SMS sessions in descending order, returning a sync_token to fetch only changes next time. |
validate_credential | Validate Zoom Phone credentials by listing phone users. |
Write (4)
Create or send data.
| Tool | What it does |
|---|---|
assign_campaign_phone_numbers | Assign one or more Zoom Phone numbers to a 10DLC SMS campaign, with the Letter-of-Authorization details the registration requires. |
assign_user_phone_numbers | Assign one or more phone numbers to a Zoom Phone user, so the user can call and text from them. |
create_external_contact | Add an external contact (a non-Zoom person reachable by call or SMS). |
send_sms | Send an SMS or MMS from a Zoom Phone number to one or more recipients. |
Delete or overwrite (11)
Remove or replace existing data.
| Tool | What it does |
|---|---|
delete_external_contact | Delete an external contact. |
delete_recording | Permanently delete a call recording. |
delete_voicemail | Permanently delete a voicemail. |
unassign_campaign_phone_number | Remove a phone number from a 10DLC SMS campaign. |
unassign_user_phone_number | Remove a phone number from a Zoom Phone user. |
update_campaign_number_opt_status | Set a consumer number's opt-in or opt-out status for a 10DLC SMS campaign (honor STOP/START requests). |
update_external_contact | Update an external contact's name, email, description, phone numbers, extension, or routing. |
update_phone_number | Update a phone number's display name, capabilities, emergency-address status, or SIP group. |
update_recording | Enable or disable auto-delete for a call recording. |
update_user | Update a Zoom Phone user's profile: extension number, emergency address, site, applied template, or the per-feature policy object. |
update_voicemail | Mark a voicemail as read or unread. |