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

# Zoom Integration: Meetings & Recordings for Agents

> Agents can list meetings, schedule calls, access cloud recordings, and manage your Zoom calendar. OAuth credentials are injected automatically.

## Overview

OneCLI 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.

## Adding the App

<Steps>
  <Step title="Go to Connections">
    Open the OneCLI dashboard and navigate to **Connections** > **Zoom**.

    <Frame caption="Zoom connection page with permissions">
      <img src="https://mintcdn.com/chartdbinc/iZaQOySCiA_ul6Jt/images/zoom-connect.png?fit=max&auto=format&n=iZaQOySCiA_ul6Jt&q=85&s=89111520b0e13ae1d2583f9880c61d9c" alt="OneCLI Zoom connection page" width="2000" height="1194" data-path="images/zoom-connect.png" />
    </Frame>
  </Step>

  <Step title="Authorize">
    Click **Connect Zoom**. You'll be redirected to Zoom to authorize OneCLI. Review the requested permissions and click **Allow**.

    <Frame caption="OAuth authorization popup">
      <img src="https://mintcdn.com/chartdbinc/iZaQOySCiA_ul6Jt/images/zoom-authorize.png?fit=max&auto=format&n=iZaQOySCiA_ul6Jt&q=85&s=16855045e71dad20ac57fe96b9db40b6" alt="OneCLI Zoom OAuth authorization" width="2000" height="1126" data-path="images/zoom-authorize.png" />
    </Frame>

    OneCLI 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.
  </Step>

  <Step title="Verify">
    After authorization, you'll be redirected back to the OneCLI dashboard. The Zoom connection will show as **Connected** with your Zoom email address.
  </Step>
</Steps>

### Prerequisites

* A Zoom account (Free, Pro, or Business)
* An OneCLI account at [app.onecli.sh](https://app.onecli.sh)

### 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**: OneCLI 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 in the **Activity** tab. You can see the method, endpoint, status, and latency for every request.

<Frame caption="Activity log showing Zoom API requests from an agent">
  <img src="https://mintcdn.com/chartdbinc/iZaQOySCiA_ul6Jt/images/zoom-activity.png?fit=max&auto=format&n=iZaQOySCiA_ul6Jt&q=85&s=46146c5cae6d9e8a0b15e3fb5d6e68ba" alt="OneCLI activity log with Zoom API calls" width="2000" height="1194" data-path="images/zoom-activity.png" />
</Frame>

### Controlling access with rules

Use OneCLI's [rules engine](/guides/rules) to limit what agents can do with your Zoom account. For example, you can allow read-only access so agents can view your meetings but not create or modify them, or restrict access to only listing recordings. Rules are evaluated before credential injection, so a blocked request never reaches the Zoom API.

## Removing the App

<Steps>
  <Step title="Disconnect from OneCLI">
    Open the OneCLI dashboard, navigate to **Connections** > **Zoom**, and click **Disconnect**. This revokes the stored OAuth token and removes the connection from your OneCLI account.
  </Step>

  <Step title="Revoke from Zoom (optional)">
    To fully revoke access, go to the [Zoom App Marketplace](https://marketplace.zoom.us/) > **Manage** > **Installed Apps**, find OneCLI, and click **Uninstall**. This ensures OneCLI can no longer access your Zoom account even if you reconnect later without re-authorizing.
  </Step>
</Steps>

### What happens when you disconnect

* OneCLI 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 OneCLI after disconnection
* Your Zoom meetings, recordings, and account are not affected

## FAQ

<AccordionGroup>
  <Accordion title="What Zoom data does OneCLI store?">
    OneCLI 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>

  <Accordion title="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>

  <Accordion title="Can I limit what agents are allowed to do?">
    Yes. Use OneCLI's [rules engine](/guides/rules) to restrict agent permissions. For example, you can grant read-only access to meetings without allowing agents to create or delete them.
  </Accordion>

  <Accordion title="What happens if my Zoom token expires?">
    OneCLI 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>

  <Accordion title="Will disconnecting OneCLI affect my Zoom account?">
    No. Disconnecting only removes the OAuth tokens stored in OneCLI. Your Zoom meetings, recordings, and account settings are not modified or deleted.
  </Accordion>
</AccordionGroup>

## Contact Support

If you run into issues with the Zoom integration:

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