Zoom
Version
This integration utilizes the Zoom User API v2.
Base URL
The base URL used for all Zoom API endpoints:https://api.zoom.us/v2/
Authentication & Authorization
The DataGrail Zoom integration connects using OAuth 2.0 with the following credentials: Client ID and Client Secret.
Scopes
The Zoom integration requires specific scopes that must be granted in order to function for a given capability.
Scope | Access |
---|---|
user:read:user:admin | ✅ |
group:read:group:admin | ✅ |
meeting:read:list_meetings:admin | ✅ |
webinar:read:list_webinars:admin | ✅ |
cloud_recording:read:list_user_recordings:admin | ✅ |
phone:read:user:admin | ✅ |
phone:read:user_setting:admin | ✅ |
phone:read:list_recordings:admin | ✅ |
phone:read:list_voicemails:admin | ✅ |
phone:read:list_call_logs:admin | ✅ |
Endpoints Utilized
DataGrail uses the following endpoints to authorize and test the connection:
Limits
Limits in Zoom are calculated using the leaky
bucket algorithm. All requests that are made after rate limits have been
exceeded are throttled and an HTTP 429 Too Many Requests
error is returned.
Requests succeed again after enough requests have emptied out of the bucket.
- DataGrail supports requests throttling to stay within 70-80% of specified service rate limits.
- DataGrail processes API responses with HTTP 429 status to interrupt requests, waiting and retrying (using an exponential backoff strategy).
Capabilities
Access
DataGrail's Zoom integration provides Synchronous Access capabilities for the following supported identifier category: Email.Data Interactions
For Access requests, DataGrail will take the following actions:
- Search for User email using the Data Subject email address.
- If a user match is found, DataGrail will extract all objects related to the user, including the following:
Match Found
- Retrieve a user's settings by user ID
- Retrieve a user's meetings by user ID
- Retrieve a user's webinars by user ID
- Retrieve a user's recordings by user ID
- Get the user's Zoom phone profile by user ID
- Retrieve the Zoom Phone profile settings of a user by user ID
- Retrieve a user's Zoom phone call logs by user ID
- Retrieve a user's Zoom Phone voicemails by user ID
- Retrieve a user's Zoom Phone recordings by user ID
Endpoints Utilized
Disclaimer: The information contained in this message does not constitute as legal advice. We would advise seeking professional counsel before acting on or interpreting any material.