> ## Documentation Index
> Fetch the complete documentation index at: /docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Let AI Agents Schedule Zoom Meetings and Get Recordings

> Let agents list and schedule Zoom meetings and access cloud recordings. Connect with Zoom OAuth, and the gateway injects tokens so agents never see them.

## Overview

Buckle connects AI agents to Zoom through Zoom's OAuth flow. Agents can list and manage meetings, access cloud recordings, and view user profile information. The gateway injects OAuth credentials into requests to the Zoom API automatically.

This is useful for scheduling agents, meeting summarizers, or any agent that needs to interact with your Zoom account.

## What you will set up

* A Zoom connection through OAuth, read access by default with optional write access
* Automatic token injection and refresh on Zoom API requests
* Per-agent, per-tool access to meetings and recordings

## Adding the App

**1. Open the app**

Open the Buckle dashboard and navigate to **Settings** > **Apps** > **Zoom**.

![The Zoom app page in the Buckle dashboard with the Connect button and the Custom credentials section](https://mintcdn.com/onecli-17d3f772/5_AFCR2UNaqNo0AT/images/zoom-connect.png?fit=max\&auto=format\&n=5_AFCR2UNaqNo0AT\&q=85\&s=497060aa8a26f873bcf3693fb818fa5b)

The Zoom app page under Settings > Apps

**2. Authorize**

Click **Connect Zoom**. You'll be redirected to Zoom to authorize Buckle. Review the requested permissions and click **Allow**.

![Buckle connect window for Zoom on Cloud, showing the Connect to Zoom button.](https://mintcdn.com/onecli-17d3f772/h1DTAVlDkLshz4JZ/images/integrations/zoom/buckle-connect-zoom.png?fit=max\&auto=format\&n=h1DTAVlDkLshz4JZ\&q=85\&s=c456f7e7eebfacf8e1d95b3b3db8563a)

The Zoom connect window on Buckle Cloud.

Buckle requests read access to your meetings, recordings, and profile by default. Write access (create, update, delete meetings) is optional and only requested if your agent needs meeting management capabilities.

**3. Verify**

After authorization, you'll be redirected back to the Buckle dashboard. The Zoom connection will show as **Connected** with your Zoom email address.

## Self-hosted: use your own Zoom app

> [!NOTE]
>
> **Skip this section on Buckle Cloud.** It's only for self-hosted Buckle without `ZOOM_CLIENT_ID` and `ZOOM_CLIENT_SECRET` set, or if you want your own company name on Zoom's consent screen.

> [accordion] 1. Create the Zoom app
>
> In the [Zoom App Marketplace](https://marketplace.zoom.us/), open **Develop** > **Build App**, choose **General App**, and select **Create**. Under **Select how the app is managed**, choose **User-managed**.
>
> ![Zoom app Basic Information with User-managed selected, and App Credentials showing the Client ID and a hidden Client Secret.](https://mintcdn.com/onecli-17d3f772/h1DTAVlDkLshz4JZ/images/integrations/zoom/01-provider-setup.png?fit=max\&auto=format\&n=h1DTAVlDkLshz4JZ\&q=85\&s=289cdb916ff9d22b9a6cd964b32c9f9f)
>
> Choose User-managed. Your Client ID and Client Secret are under App Credentials.

> [accordion] 2. Add the redirect URL
>
> In Buckle, open **Settings** > **Apps** > **Zoom** > **Custom credentials** and copy the **Redirect URI**. In Zoom, open **Basic Information** > **OAuth Information**, paste it into **OAuth Redirect URL**, and add it to the **OAuth Allow List** too.
>
> ![Buckle Custom credentials card for Zoom with the setup guide link, the Redirect URI and its copy button, and the client ID and secret fields.](https://mintcdn.com/onecli-17d3f772/h1DTAVlDkLshz4JZ/images/integrations/zoom/buckle-custom-credentials-zoom.png?fit=max\&auto=format\&n=h1DTAVlDkLshz4JZ\&q=85\&s=12b694313f90a1a210e7c67416648adb)
>
> Copy the Redirect URI from Custom credentials in Buckle.
>
> ![Zoom app OAuth Information with https://buckle.example.com/v1/apps/zoom/callback in OAuth Redirect URL and in OAuth Allow Lists.](https://mintcdn.com/onecli-17d3f772/h1DTAVlDkLshz4JZ/images/integrations/zoom/02-provider-redirect.png?fit=max\&auto=format\&n=h1DTAVlDkLshz4JZ\&q=85\&s=f5e187ef626bfa6e056a350ab9c7ce9b)
>
> The Buckle Redirect URI in both OAuth Redirect URL and OAuth Allow Lists.

> [accordion] 3. Add the scopes
>
> Open **Scopes** > **Add Scopes** and add:
>
> `user:read:user`, `meeting:read:list_meetings`, `meeting:read:meeting`, `meeting:write:meeting`, `meeting:update:meeting`, `meeting:delete:meeting`, `cloud_recording:read:list_user_recordings`, `cloud_recording:read:list_recording_files`

> [accordion] 4. Connect with your app
>
> On **Basic Information**, copy the **Client ID** and **Client Secret**. Paste both into **Settings** > **Apps** > **Zoom** > **Custom credentials**, select **Save credentials**, then **Connect** and click **Allow** in Zoom.

> [accordion] Prerequisites and troubleshooting
>
> **Prerequisites**
>
> * A Zoom account (Free, Pro, or Business)
> * A Buckle account at [app.buckle.dev](https://app.buckle.dev)
>
> **Troubleshooting**
>
> * **Authorization fails**: Ensure pop-ups are not blocked by your browser during the OAuth redirect.
> * **Missing scopes**: If your agent can't perform certain actions, disconnect and reconnect Zoom to request the optional write scopes.
> * **Token expired**: Buckle automatically refreshes expired tokens. If you encounter persistent auth errors, disconnect and reconnect.

## Usage

### What agents can do

**Meetings (read)**

* List scheduled and past meetings for your account
* Get details for a specific meeting (topic, start time, duration, join URL, participants)

**Meetings (write, optional)**

* Schedule new meetings with topic, time, duration, and settings
* Update existing meetings (reschedule, change topic, modify settings)
* Delete meetings

**Cloud Recordings**

* List all cloud recordings for your account
* Access recording files for a specific meeting (video, audio, transcript)

**User Profile**

* View your Zoom profile (name, email, account type)

### Example use cases

* **Meeting prep agent**: Pulls your upcoming meetings and prepares agendas or briefing docs
* **Recording summarizer**: Accesses cloud recordings and generates meeting summaries
* **Scheduling assistant**: Creates Zoom meetings based on calendar availability
* **Meeting cleanup**: Identifies and removes outdated or cancelled meetings

### Activity log

All Zoom API requests made by agents are logged on the agent's **Activity** page, under **Traffic**. You can see the method, endpoint, status, and latency for every request.

![An agent's Activity page in the Buckle dashboard, with Zoom API calls in the Traffic tab](https://mintcdn.com/onecli-17d3f772/5_AFCR2UNaqNo0AT/images/zoom-activity.png?fit=max\&auto=format\&n=5_AFCR2UNaqNo0AT\&q=85\&s=60e35d8788d8484d2a62512fbee2fe63)

The Traffic tab of an agent's Activity page, showing Zoom API requests

### Controlling access

Access is per agent: [grant](/docs/guides/agent-access.md) the connection to each agent that needs it, choosing per tool what runs freely, what needs human approval, and what stays blocked — a read-only agent is a single grant. Organization [rules](/docs/guides/rules.md) add guardrails on top, like rate limits and blanket blocks. Everything is checked before credential injection, so a blocked request never reaches the Zoom API.

## Removing the App

> [accordion] Removing the app
>
> **1. Disconnect from Buckle**
>
> Open the Buckle dashboard, navigate to **Settings** > **Apps** > **Zoom**, and click **Disconnect**. This revokes the stored OAuth token and removes the connection from your Buckle account.
>
> **2. Revoke from Zoom (optional)**
>
> To fully revoke access, go to the [Zoom App Marketplace](https://marketplace.zoom.us/) > **Manage** > **Installed Apps**, find Buckle, and click **Uninstall**. This ensures Buckle can no longer access your Zoom account even if you reconnect later without re-authorizing.
>
> **What happens when you disconnect**
>
> * Buckle immediately deletes your stored OAuth tokens (access and refresh tokens)
> * Any agents using the Zoom connection will receive authorization errors
> * No Zoom data is retained by Buckle after disconnection
> * Your Zoom meetings, recordings, and account are not affected

## FAQ

> [accordion] What Zoom data does Buckle store?
>
> Buckle only stores your OAuth tokens (encrypted with AES-256) and basic profile metadata (name and email) used to display the connection status. No meeting content, recording data, or personal information is stored.

> [accordion] Do I need a paid Zoom account?
>
> No. The integration works with Free, Pro, and Business Zoom accounts. Some features like cloud recordings may require a Zoom plan that supports them.

> [accordion] Can I limit what agents are allowed to do?
>
> Yes. [Grant](/docs/guides/agent-access.md) the Zoom connection per agent with per-tool access — for example, allow reading meetings while blocking create and delete. Organization [rules](/docs/guides/rules.md) can add guardrails on top.

> [accordion] What happens if my Zoom token expires?
>
> Buckle automatically refreshes expired tokens using the stored refresh token. No action is needed on your part. If a refresh fails, disconnect and reconnect Zoom from the dashboard.

> [accordion] Does the agent see my Zoom token?
>
> No. The token stays in Buckle, and the gateway adds it at the proxy. See [How it works](/docs/how-it-works.md).

> [accordion] Will disconnecting Buckle affect my Zoom account?
>
> No. Disconnecting only removes the OAuth tokens stored in Buckle. Your Zoom meetings, recordings, and account settings are not modified or deleted.

## Contact Support

If you run into issues with the Zoom integration:

* **Email**: [support@buckle.dev](mailto:support@buckle.dev)
* **Discord**: [discord.gg/PSztzsQB3g](https://discord.gg/PSztzsQB3g)
* **Response time**: We aim to respond within 24 hours on business days


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.