Skip to main content

Overview

What it does

Zoom integration connects AI tools directly to your Zoom account, enabling natural language interactions with meetings, webinars, recordings, and user management.Key Features:
  • Schedule and manage meetings
  • Create and configure webinars
  • Manage meeting registrants
  • Access and download recordings
  • Generate usage reports and analytics
  • Get meeting summaries (AI Companion)
  • List and manage devices
  • Access archived files
  • Track participant attendance

Use Cases

Meeting Management:
  • Automatically schedule team meetings
  • Coordinate interview schedules
  • Set up recurring standups and reviews
  • Manage webinar registrations
Analytics and Reporting:
  • Generate daily usage reports
  • Track meeting attendance
  • Analyze participant engagement
  • Export recording analytics
Automation:
  • Create meetings programmatically
  • Download and archive recordings
  • Manage webinar registrations at scale
  • Generate AI-powered meeting summaries

Quick Start

1

Connect Your Zoom Account

NimbleBrain Studio uses OAuth2 to securely connect to your Zoom account.
  1. Navigate to Connections in the sidebar
  2. Click Browse Catalog
  3. Search for “Zoom”
  4. Click Install
  5. Click Connect and authorize with your Zoom account
  6. Grant the requested permissions
OAuth2 provides secure, token-based authentication. You’ll need to authorize access to your Zoom account.
2

Verify Connection

Once connected, test the integration:
"Show me my upcoming Zoom meetings"
Other test prompts:
  • “Schedule a team meeting for tomorrow at 2pm”
  • “List all my Zoom recordings from last week”
  • “Show me today’s meeting attendance”

Available Tools

The Zoom connection provides 17+ tools organized into the following categories:

Meeting Management

Create, view, update, and manage Zoom meetings.
ToolDescription
ZOOM_CREATE_A_MEETINGSchedule a new Zoom meeting (uses ‘me’ for user-level apps)
ZOOM_GET_A_MEETINGGet details about a specific meeting
ZOOM_UPDATE_A_MEETINGUpdate meeting settings and details
ZOOM_LIST_MEETINGSList all scheduled meetings for a user
ZOOM_GET_A_MEETING_SUMMARYGet AI-generated meeting summary (requires Pro+ and AI Companion)
Example Usage:
"Schedule a team standup for tomorrow at 9am, 30 minutes long"
Meeting updates have a limit of 100 requests/day and 100 updates per meeting in 24 hours. Start time must be future-dated.

Meeting Participants

Manage meeting registrants and track attendance.
ToolDescription
ZOOM_ADD_A_MEETING_REGISTRANTRegister users for meetings (max 4,999 registrants)
ZOOM_GET_PAST_MEETING_PARTICIPANTSGet list of attendees from past meetings (Pro+ required)
Example Usage:
"Register [email protected] for the product demo meeting"
Past meeting participants API requires Pro plan or higher and excludes solo participants.

Webinar Management

Create and manage webinars for larger audiences (up to 10,000 attendees).
ToolDescription
ZOOM_GET_A_WEBINARGet webinar details (requires Pro+ and webinar add-on)
ZOOM_LIST_WEBINARSList all scheduled webinars for a user
ZOOM_ADD_A_WEBINAR_REGISTRANTRegister attendees for webinars
ZOOM_LIST_WEBINAR_PARTICIPANTSGet list of past webinar participants
Example Usage:
"Show me all upcoming webinars"
Webinar features require Pro plan or higher plus the webinar add-on. Only unexpired webinars are listed.

Recordings

Access, download, and manage cloud recordings.
ToolDescription
ZOOM_LIST_ALL_RECORDINGSList all cloud recordings for a user
ZOOM_GET_MEETING_RECORDINGSGet recordings for a specific meeting (includes download URL)
ZOOM_DELETE_MEETING_RECORDINGSDelete all recordings for a meeting
Example Usage:
"Show me all recordings from last month"
Cloud recording must be enabled on your account. Use the download URL from GET_MEETING_RECORDINGS to download files.

Reports & Analytics

Generate usage reports and analytics.
ToolDescription
ZOOM_GET_DAILY_USAGE_REPORTGet daily Zoom usage details (new users, meetings, participants, minutes)
Example Usage:
"Show me Zoom usage statistics for last week"

Devices & Archives

Manage devices and archived files.
ToolDescription
ZOOM_LIST_DEVICESList all devices associated with the account
ZOOM_LIST_ARCHIVED_FILESList archived meeting data (requires archiving feature)
Example Usage:
"List all devices registered to my Zoom account"
Meeting archiving requires the archiving feature to be enabled and is used for compliance purposes.

Example Workflows

Scenario: Set up recurring team standup meetingsPrompt:
"Create a Zoom meeting called 'Engineering Daily Standup' for tomorrow at 9am, 30 minutes long"
What happens:
  • Creates meeting with specified settings
  • Generates meeting link
  • Returns meeting ID and join URL

Authentication

OAuth2 Authentication: This connection uses OAuth2 for secure authentication.

How It Works

When you connect Zoom in NimbleBrain Studio:
  1. You’ll be redirected to Zoom’s authorization page
  2. Log in with your Zoom account
  3. Review and grant permissions
  4. You’re automatically redirected back to Studio

Required Scopes

The integration requests scopes based on the features you need: Meeting Scopes:
  • meeting:read / meeting:read:admin - View meeting details
  • meeting:write / meeting:write:admin - Create and update meetings
Recording Scopes:
  • recording:read / recording:read:admin - View recordings
  • recording:write / recording:write:admin - Manage recordings
  • cloud_recording:read - Access cloud recordings
Webinar Scopes:
  • webinar:read / webinar:read:admin - View webinars
  • webinar:write / webinar:write:admin - Create webinars
User & Report Scopes:
  • user:read / user:read:admin - View user info
  • report:read:admin - Access reports
  • dashboard:read:admin - View dashboard
Other Scopes:
  • meeting_summary:read - Access AI meeting summaries
You can manage connected apps in your Zoom account under SettingsApps.

Plan Requirements

Different features require different Zoom plan levels:
FeatureRequired Plan
Basic meetingsFree
Cloud recordingPro+
Meeting summaries (AI)Pro+ with AI Companion
WebinarsPro+ with Webinar add-on
Past participantsPro+
Admin reportsPro+
Meeting archivingBusiness+ with archiving
Free plan meetings are limited to 40 minutes for group meetings. Some API features require paid plans.

Rate Limits

Zoom enforces rate limits to ensure platform stability:
Limit TypeRestriction
Meeting creation100/day (Free), higher on paid plans
Meeting updates100 updates per meeting per 24 hours
General API calls80 requests/second (varies by endpoint)
Report generationLower limits (varies)
Rate Limit Labels:
  • Light - Higher limits, less restrictive
  • Medium - Standard limits
  • Heavy - More restrictive, use sparingly
Studio automatically handles rate limiting and retries with exponential backoff.

Troubleshooting

Issue: OAuth authorization didn’t completeSolutions:
  • Ensure you’re logged into the correct Zoom account
  • Try a different browser or incognito mode
  • Check popup blockers aren’t interfering
  • Verify your Zoom account is active
Issue: Insufficient privileges errorSolutions:
  • Reconnect to grant additional scopes
  • Verify your Zoom role has required permissions
  • Some features require admin role
  • Check your plan supports the feature
Issue: Cannot get meeting summarySolutions:
  • Requires Pro plan or higher
  • AI Companion must be enabled in account settings
  • Not available for E2EE (end-to-end encrypted) meetings
  • Summary may take time to generate after meeting ends
Issue: Webinar API returns errorSolutions:
  • Webinars require Pro plan or higher
  • Must have webinar add-on purchased
  • Verify webinar license is assigned to user
  • Check webinar capacity matches your plan
Issue: Cannot access recordingsSolutions:
  • Cloud recording must be enabled on account
  • Recording may still be processing
  • Check if recording was deleted
  • Verify you have access to the host’s recordings
Issue: Too many requests errorSolutions:
  • Wait for rate limit to reset
  • Reduce frequency of requests
  • Upgrade plan for higher limits
  • Studio automatically handles retries

Best Practices

Meeting Organization

  • Use consistent naming conventions
  • Set appropriate meeting durations
  • Enable waiting rooms for external meetings
  • Use passwords for sensitive meetings
  • Schedule recurring meetings for regulars

Security

  • Enable waiting rooms for client meetings
  • Use passwords for all meetings
  • Lock meetings once started
  • Control screen sharing permissions
  • Review connected apps regularly

Recording Management

  • Set auto-recording for important meetings
  • Download and archive critical recordings
  • Delete old recordings to save storage
  • Use archiving for compliance needs
  • Set retention policies

Participant Experience

  • Test settings before important meetings
  • Send invites well in advance
  • Use clear, descriptive meeting names
  • Provide agenda in meeting description
  • Enable captions for accessibility

Need help? Join the NimbleBrain Discord or email [email protected]