This article walks you through how to integrate Zoom with Swyft AI, the permissions (scopes) required, and how user permissions are respected during setup. Swyft AI connects to Zoom via OAuth, meaning a Zoom admin must approve the integration and grant the necessary scopes.
1. Overview
Swyft AI uses Zoom’s APIs to read meeting data, participant information, and cloud recordings to generate actionable insights and automate workflows from meetings.
Important: Swyft AI cannot perform any actions in Zoom that haven’t been approved by your Zoom admin or that exceed the permissions granted. We do not override your organization’s Zoom security settings.
2. Required Scopes
When authorizing Swyft AI to connect to Zoom, you will be prompted to grant the following scopes:
Meetings
meeting:read:list_past_participants:admin
meeting:read:meeting:admin
These allow Swyft AI to read meeting details and participant lists for analysis and workflow automation.
Cloud Recordings
cloud_recording:read:recording:admin
cloud_recording:read:list_user_recordings:admin
cloud_recording:read:list_recording_files:admin
cloud_recording:read:recording:master
These enable Swyft AI to access and analyze meeting recordings.
User Information
user:read:settings:admin
user:read:user:admin
user:read:list_users:admin
Allows Swyft AI to retrieve user details (e.g., names, settings) to associate meeting data with the correct participants.
User Settings Updates
user:update:settings:admin
Lets Swyft AI make specific updates to user settings if needed for workflow configurations (only as approved by your Zoom admin).
Why these scopes?
Meeting & Recording Data: Swyft AI needs to read your meeting information and recordings to generate insights and automate tasks.
User Information: Ensures accurate identification of meeting hosts, participants, and relevant user settings.
Administrative Approval: Because these scopes involve organizational data, a Zoom admin must grant them to ensure compliance with security policies.
3. Setting Up the Integration
Go to the Integrations Page in Swyft AI: From your Swyft AI account, navigate to Integrations.
Click “Connect” Next to Zoom: This will open the Zoom OAuth permissions screen.
Admin Approval: A Zoom Account Admin must grant one-time approval for Swyft AI to connect.
You’re All Set: After approval, Swyft AI can read meeting details, participant lists, and cloud recordings based on your Zoom workspace policies—no extra setup required.
4. Respecting Zoom Permissions & Security
Admin-Controlled Access: All of Swyft AI’s actions in Zoom are governed by the scopes your Zoom admin grants.
No Overrides: Swyft AI does not bypass Zoom security settings or privacy controls. If certain data is restricted, Swyft AI cannot access it.
Granular Controls: You can revoke or modify Swyft AI’s access at any time in your Zoom Account settings.
5. Troubleshooting & FAQs
Q: Why does Swyft AI need these scopes?
A: Each scope allows Swyft AI to read or analyze specific Zoom data (e.g., meeting recordings, participant lists). Without them, our workflows and automations wouldn’t function effectively.Q: Do I need to re-authenticate periodically?
A: Typically no, unless your Zoom policies require periodic re-authentication or token refresh.Q: Will Swyft AI override any Zoom privacy settings?
A: No, Swyft AI respects existing Zoom permissions. If recordings or user data are restricted, Swyft AI cannot access them.
If you have any further questions about setting up or managing your Zoom integration, please reach out to our support team at [email protected]. We’re here to help you get the most out of your Swyft AI experience!