Product updates

Developer Changelog

Keep track of changes and upgrades to the Zoom Developer platform. You can also subscribe to our Changelog RSS feed below.


Phone

Deprecation of Call Log APIs and enhancements to Call History APIs

Breaking changeDeprecation

Summary:Zoom Phone API introduced new endpoints in December 2023 to replace Call Logs. The v1 Call Logs APIs will be deprecated in May 2026. This timeline extends the previously announced deprecation to give developers more time to migrate. Key migration endpoints - Get account call history: Returns summaries of all inbound and outbound calls. Available to admins using account-level OAuth apps with required scopes. - Get call history: Returns detailed call path logs. (Previously named Get call path.) Use this guide to migrate: https://developers.zoom.us/docs/phone/migrate/.

Added

New Call Logs APIs

  • GET /v2/phone/call_history/{callHistoryUuid}
  • GET /v2/phone/call_element/{callElementId}
  • GET /v2/accounts/{accountId}/phone/call_element/{callElementId}
  • GET /v2/accounts/{accountId}/phone/call_history/{callHistoryUuid}

Enhancements

Recordings APIs

Added a new call_element_id field to the response of:

  • GET /v2/phone/call_logs/{id}/recordings
  • GET /v2/accounts/{accountId}/phone/call_logs/{id}/recordings
  • GET /v2/phone/users/{userId}/recordings
  • GET /v2/accounts/{accountId}/phone/users/{userId}/recordings
  • GET /v2/accounts/{accountId}/phone/recordings
  • GET /v2/phone/recordings

Voicemails APIs

Added a new call_element_id field to the response of:

  • GET /v2/accounts/{accountId}/phone/voice_mails/{voicemailId}
  • GET /v2/phone/voice_mails/{voicemailId}
  • GET /v2/accounts/{accountId}/phone/users/{userId}/call_logs/{id}/voice_mail
  • GET /v2/phone/users/{userId}/call_logs/{id}/voice_mail
  • GET /v2/accounts/{accountId}/phone/voice_mails
  • GET /v2/phone/voice_mails
  • GET /v2/accounts/{accountId}/phone/users/{userId}/voice_mails
  • GET /v2/phone/users/{userId}/voice_mails

Call Logs APIs

Added a new call_history response field to:

  • GET /v2/phone/call_history
  • GET /v2/accounts/{accountId}/phone/call_history Added a new call_elements response field to:
  • GET /v2/phone/users/{userId}/call_history/sync
  • GET /v2/accounts/{accountId}/phone/users/{userId}/call_history/sync
  • GET /v2/accounts/{accountId}/phone/users/{userId}/call_history

Call Logs APIs

Added a new call_history response field to:

  • GET /v2/phone/call_history
  • GET /v2/accounts/{accountId}/phone/call_history Added a new call_elements response field to:
  • GET /v2/phone/users/{userId}/call_history/sync
  • GET /v2/accounts/{accountId}/phone/users/{userId}/call_history/sync
  • GET /v2/accounts/{accountId}/phone/users/{userId}/call_history

Webhook Events

New webhooks

If your application currently subscribes to the earlier call-history webhooks, we recommend reviewing your subscriptions and switching to the following events where appropriate:

  • phone.call_element_deleted
  • phone.callee_call_element_completed
  • phone.caller_call_element_completed

Deprecated webhooks

  • phone.call_history_deleted
  • phone.callee_call_history_completed
  • phone.caller_call_history_completed
  • phone.call_log_deleted
  • phone.call_log_permanently_deleted
  • phone.callee_call_log_completed
  • phone.caller_call_log_completed

Enhancements

Added a new call_element_id field to webhook payloads for:

  • phone.voicemail_transcript_completed
  • phone.recording_completed_for_access_member
  • phone.voicemail_received
  • phone.recording_completed
  • phone.voicemail_received_for_access_member