Introduction
Using Zoom APIs
Pagination
Error Definitions
Rate Limits
Testing Zoom APIs
Accounts
Billing
Chat Channels
Chat Channels (Account-level)
Chat Messages
Chatbot Messages
Contacts
Cloud Recording
Dashboards
Devices
Groups
IM Chat
IM Groups
Meetings
PAC
Phone
Phone Auto Receptionists
Phone Blocked List
Phone Call Queues
Phone Devices
Phone Reports
Phone Shared Line Groups
Phone Site
Common Area Phones
Reports
Roles
Rooms
Rooms Account
Rooms Location
SIP Phone
TrackingField
TSP
Users
Webinars
Rooms Devices
SIP Connected Audio
Deprecated API Endpoints
Data Compliance

Recording Completed


All users with a Pro or a higher plan have access to Cloud Recordings. An account owner or account admin can enable Cloud Recording for all account members as well as for members that belong to a certain group. Users can also enable Cloud Recordings for their own use.

Only a host or a co-host of the meeting/webinar can start and complete a Cloud Recording. A recording is considered to be completed after the meeting or webinar which was being recorded is ended by the host/co-host.

The Recording Completed event is triggered every time a recording of a meeting or webinar becomes available to view and/or download. To receive this notification, you must meet the prerequisites listed below.

Prerequisites

  • Pro or higher plan.
  • Cloud recording must be enabled on the users’ account.
  • Event Subscriptions must be enabled for your Marketplace app with the following configurations:
    • A valid Event notification endpoint URL.
    • "All Recordings have completed" subscription must be enabled under the Recording event.

The tabs below display the complete schema, payload with data types, and an example of the recording.completed event notification:

Recording Completed Event Notification
recording.completed
object
event
string

Name of the event.

payload
object
download_token
string

Use this token along with the download_url to download the Cloud Recording via an OAuth app. This token only lasts for 24 hours after generation and thus, you can only download the file within 24 hours of receiving the “recording.completed” event notification.

You can either include the download_token as a query parameter or pass it as a Bearer token in the Authorization header of your HTTP request.

Using Authorization Header (Recommended)

curl --request GET \
  --url {download_url} \
  --header 'authorization: Bearer {download_token} \
  --header 'content-type: application/json'

Using Query Parameter

The URL to download this type of recording will follow this structure: {download_url}/?access_token={download_token}

Example: https://zoom.us/recording/download/bdfdgdg?access_token=abvdoerbfg