Fellow uses the OAuth2 protocol to connect to the Zoom API on behalf of users. OAuth2 ensures that Fellow can only access the specific resources it's been authorized for - these are called scopes. The sections below describe each scope, why it's needed, and which integration it applies to.

All Zoom integrations in Fellow are optional. There are three integration components, each with their own scope requirements:

The Zoom Integration allows you to create Zoom conference links for events directly within Fellow, use Fellow from inside the Zoom client, and record meetings without a bot joining the call, using Zoom's Real-Time Media Streaming (RTMS).

Note: To create Zoom links when creating or editing events in Fellow, the full Zoom Integration must be installed.

meeting:read:meeting Description: Get information about a Zoom meeting. Why Fellow needs it: Required to retrieve meeting details so Fellow can open the correct note automatically when the app is launched during a call.

meeting:write:meeting Description: Create new Zoom meetings. Why Fellow needs it: Required to generate Zoom conference links when creating calendar events within Fellow. This scope is only used while the user is active in the app.

cloud_recording:read:recording Description: Get the URL of a Zoom meeting recording. Why Fellow needs it: Allows Fellow to automatically insert the Zoom recording URL into the associated meeting note for easy access. Fellow does not access the contents of the recording itself.

user:read:user Description: Get basic information about a Zoom user. Why Fellow needs it: Used to retrieve the Zoom user's ID and email address so Fellow can display which Zoom account is currently connected.

zoomapp:inmeeting Description: Allows Fellow to run as a Zoom app. Why Fellow needs it: Required for Fellow to be installed and opened within the Zoom client. This scope is only used while the user is active in the app.

meeting:read:local_recording_token Description: Get a local recording token for a Zoom meeting. Why Fellow needs it: Required to allow bots to directly record a meeting hosted by the user, bypassing the waiting room and recording permission prompt.

meeting:update:participant_rtms_app_status Description: Update the RTMS app status for a participant in a meeting. Why Fellow needs it: Required to enable and manage the real-time media stream connection for botless recording during a live meeting.

meeting:read:meeting_audio Description: Access the audio stream of a Zoom meeting via RTMS. Why Fellow needs it: Required to capture meeting audio for transcription and recap generation during Native Capture sessions.

meeting:read:meeting_video Description: Access the video stream of a Zoom meeting via RTMS. Why Fellow needs it: Required to capture meeting video during Native Capture sessions.

meeting:read:meeting_screenshare Description: Access the screenshare stream of a Zoom meeting via RTMS. Why Fellow needs it: Required to capture shared screen content during Native Capture sessions.

meeting:read:meeting_transcript Description: Access the real-time transcript of a Zoom meeting via RTMS. Why Fellow needs it: Required to capture the live meeting transcript during Native Capture sessions.

rtms:read:rtms_started Description: Receive a notification when an RTMS session starts. Why Fellow needs it: Required so Fellow knows when to begin capturing during a Native Capture session.

rtms:read:rtms_stopped Description: Receive a notification when an RTMS session stops. Why Fellow needs it: Required so Fellow knows when a Native Capture session has ended.

The Zoom Admin App enables organization-wide management of Fellow's Zoom integration at the admin level.

meeting:read:meeting:admin Description: Get information about any Zoom meeting in the account. Why Fellow needs it: Required for admins to retrieve meeting details across the workspace, enabling organization-wide Note Taker and recording management.

meeting:update:participant_rtms_app_status:admin Description: Update the Real-Time Media Streaming (RTMS) app status for meeting participants. Why Fellow needs it: Required to manage Native Capture (botless recording) functionality at the admin level across the workspace.

meeting:read:local_recording_token:admin Description: Get a local recording token for any Zoom meeting in the account. Why Fellow needs it: Required to allow bots to directly record any meeting hosted by the Zoom workspace, bypassing the waiting room and recording permission prompt.

The Zoom Chat App connects Fellow with Zoom Chat, allowing meeting notes and recaps to be sent directly to Zoom Chat channels. Use this if your organization uses Zoom Chat instead of Slack or Microsoft Teams.

imchat:bot Description: Allows Fellow to run as a Zoom Chat bot. Why Fellow needs it: Required for Fellow to be installed and send messages within Zoom Chat.

user:read:admin Description: Get information about users in a Zoom account. Why Fellow needs it: Required to retrieve user IDs, which are used to present the list of Zoom Chat channels a user can send meeting notes to. This scope is only used while the user is active in the app.

chat_channel:read:admin Description: Get the list of chat channels in a Zoom account. Why Fellow needs it: Allows users to select a Zoom Chat channel to send their Fellow meeting notes to. This scope is only used while the user is active in the app.