Skip to main content

Zoom

Prefer guided AI setup?

Instead of following these steps manually, you can use the AI Credential Assistant — describe what you want to connect and the AI will walk you through the setup step by step, tailored to your account.

Overview​

Connect your Zoom account to Nirvai to manage meetings, recordings, and user data programmatically through OAuth2 authentication.

Supported Authentication Methods​

  • OAuth2 - Recommended for secure, user-authorized access to Zoom services

Prerequisites​

  • A Zoom account (free or paid)
  • Access to the Zoom App Marketplace
  • Developer permissions to create and manage OAuth apps

Setup Instructions​

Creating an OAuth App​

  1. Log in to the Zoom App Marketplace
  2. Click Develop in the top navigation and select Build App
  3. Choose OAuth as the app type
  4. Click Create
  5. Enter an App Name (e.g., "Nirvai Integration")
  6. Select User-managed app
  7. Toggle Would you like to publish this app on Zoom App Marketplace? to OFF (for internal use)
  8. Click Create

Configuring OAuth Settings​

  1. In the App Credentials section, note your:
    • Client ID
    • Client Secret
  2. Add the Nirvai redirect URI in Redirect URL for OAuth: 
    https://api.nirvai.com/oauth/zoom/callback
  3. Add the same URL to Add Allow Lists (whitelist)

Setting Scopes​

In the Scopes section, add the following permissions:

ScopePurpose
user:readRead user profile information
user:read:adminRead user info (admin level)
meeting:readView meeting details
meeting:read:adminView meetings (admin level)
meeting:writeCreate and manage meetings
meeting:write:adminManage meetings (admin level)
recording:readAccess meeting recordings
recording:read:adminAccess recordings (admin level)
recording:write:adminManage recordings (admin level)

Completing Setup in Nirvai​

  1. In Nirvai, navigate to Credentials
  2. Click Add Credential and select Zoom OAuth2
  3. Click Connect with Zoom
  4. Authorize the app when prompted
  5. Your credential will be saved automatically

Available API Operations​

With your Zoom OAuth2 credential, you can:

  • Create, update, and delete meetings
  • List and view scheduled meetings
  • Access and manage meeting recordings
  • Get user profile information
  • Manage meeting participants
  • Configure meeting settings

Troubleshooting​

Common Issues​

  • 401 Unauthorized: Token has expired. Nirvai will automatically refresh tokens when possible.
  • 403 Forbidden: Missing required scopes or insufficient permissions.
  • 404 Not Found: Meeting or resource doesn't exist or was deleted.
  • Rate Limits: Zoom API has rate limits; contact Zoom for increased limits if needed.

Token Refresh​

OAuth tokens expire after 1 hour. Nirvai handles token refresh automatically using the refresh token. If you encounter persistent authentication issues:

  1. Revoke the existing credential in Nirvai
  2. Reconnect your Zoom account
  3. Re-authorize the required scopes

App Activation​

For production use:

  1. Complete all required fields in the Zoom app configuration
  2. Add app information (description, icons, etc.)
  3. Submit for activation (internal apps can be activated instantly)

Plan Limitations​

Some API features require specific Zoom plans:

FeatureRequired Plan
Basic meetingsAll plans
Cloud recordingsPro or higher
Meeting reportsBusiness or higher
Large meetingsLarge Meeting add-on
WebinarsWebinar add-on

Security Best Practices​

  • Keep your Client ID and Client Secret confidential
  • Use the minimum required scopes for your use case
  • Regularly review connected applications in Zoom settings
  • Monitor API usage through the Zoom App Marketplace dashboard

Adapted for Nirvai platform

Next Steps​

Got your credential? Connect it to an agent

Use the AI Tool Creator to turn this credential into agent-callable tools. Describe what your agent should be able to do and the AI investigates the API, configures the endpoints, and gives you a reviewable toolkit before saving anything.