Documentation Index
Fetch the complete documentation index at: https://docs.pipeshub.com/llms.txt
Use this file to discover all available pages before exploring further.
Overview
The Zoom toolset enables AI agents to interact with your Zoom account. Agents can schedule and update meetings (including recurring series), look up upcoming calls, fetch meeting invitations and transcripts, browse contacts, and list Zoom Docs — all through natural language. This toolset is ideal for automating calendar-adjacent workflows and bringing meeting context into conversational AI.Key Capabilities
- Meeting management - Create, update, delete, and list meetings (single and recurring)
- Recurring series - Update or delete a single occurrence or the entire series
- Invitations - Pull the invitation text and join link for any meeting
- Transcripts - Fetch parsed, timestamp-aligned transcripts for recorded meetings
- Contacts - List and look up company, external, or personal Zoom contacts
- Zoom Docs - Browse files and folders inside Zoom Docs
Available Tools
Meetings
| Tool | Description |
|---|---|
list_meetings | List meetings for a user within a date range, with optional search filtering |
list_upcoming_meetings | List a user’s upcoming meetings |
list_recurring_meetings_ending_in_range | List recurring meeting series ending within a date range |
get_meeting | Get details for a specific meeting (join URL, time, settings) |
create_meeting | Create a one-off or recurring meeting with full recurrence options |
update_meeting | Update a meeting series or a specific occurrence (only supplied fields change) |
delete_meeting | Delete a meeting series or occurrence, with optional cancellation reminder |
get_meeting_invitation | Get the invitation text and join link for a meeting |
Transcripts
| Tool | Description |
|---|---|
get_meeting_transcript | Fetch and parse the VTT transcript of a recorded meeting into timestamped segments |
Contacts
| Tool | Description |
|---|---|
list_contacts | List the user’s contacts, filtered by type (company, external, personal) |
get_contact | Get details for a specific contact by email, user ID, or member ID |
User Profile
| Tool | Description |
|---|---|
get_my_profile | Get the authenticated Zoom user (name, email, timezone, account type) |
Zoom Docs
| Tool | Description |
|---|---|
list_folder_children | List files and folders inside a Zoom Docs folder |
Configuration Guide
Setup
Setup
Step 1: Create a Zoom General App
Zoom replaced the standalone “OAuth App” type with the General App type, which supports the same 3-legged OAuth flow.- Sign in to the Zoom App Marketplace with your Zoom account.
- Click Develop in the top-right corner, then Build App.
- Select General App and click Create.
You need the Developer role on your Zoom account to create apps. If you don’t see the Develop menu, ask your Zoom account owner or admin to grant the Developer role.
Step 2: Choose App Type — User-managed
In the app creation dialog, choose:| Field | Value |
|---|---|
| Select how the app is managed | User-managed |
| Would you like to publish this app on Zoom App Marketplace? | No (keep private) |
Step 3: Get the Redirect URI from PipesHub
Before filling in the Zoom form, copy the Redirect URI from PipesHub so the values match exactly.- In PipesHub, go to Workspace Settings → Actions.
- Find Zoom in the list and click + Setup (or Configure).
- Copy the Redirect URI shown in the dialog.
Step 4: Configure OAuth Information
In the Zoom app builder, open Basic Information and scroll to OAuth Information:- Paste the PipesHub Redirect URI into the OAuth Redirect URL field.
- Add the same URL to the OAuth Allow List below.
- Click Save.
Step 5: Add required scopes
Open the Scopes section in the app builder and add the following granular scopes:Meeting Scopes
| Scope | Purpose |
|---|---|
meeting:read:meeting | Read meeting details |
meeting:write:meeting | Create meetings |
meeting:update:meeting | Update meetings |
meeting:delete:meeting | Delete meetings |
meeting:read:list_meetings | List a user’s meetings |
meeting:read:list_upcoming_meetings | List upcoming meetings |
meeting:read:list_past_instances | List past instances of recurring meetings (needed for transcripts) |
meeting:read:invitation | Read the meeting invitation text |
User Scopes
| Scope | Purpose |
|---|---|
user:read:user | Read the authenticated user’s profile |
user:read:email | Read the authenticated user’s email |
Recording / Transcript Scopes
| Scope | Purpose |
|---|---|
cloud_recording:read:recording | Read cloud recording metadata |
cloud_recording:read:meeting_transcript | Read meeting transcripts |
Contact Scopes
| Scope | Purpose |
|---|---|
contact:read:list_contacts | List the user’s Zoom contacts |
Zoom Docs Scopes
| Scope | Purpose |
|---|---|
docs:read:list_children | List contents of a Zoom Docs folder |
Use the Granular scopes format shown above — Zoom’s classic scopes (e.g.,
meeting:read) are being phased out. If you add or remove scopes later, existing users must re-authorize to pick up the changes.Step 6: Copy Client ID and Client Secret
- Go to Basic Information → App Credentials in the Zoom app builder.
- Copy the Client ID — used as Client ID in PipesHub.
- Copy the Client Secret — used as Client Secret in PipesHub.
Step 7: Configure the Zoom toolset in PipesHub
- In PipesHub, return to Workspace Settings → Actions.
- Find Zoom and open setup / configuration (+ Setup or Configure).
- Confirm the Redirect URI in the dialog matches the OAuth Redirect URL you registered in Zoom in Step 4.
- Paste your Client ID and Client Secret, then save the instance.
Step 8: Authenticate the Zoom toolset
Authentication uses the same OAuth flow in either location:- Admins can authenticate the shared instance directly under Workspace Settings → Actions.
- Users can authenticate their own personal instance under Your actions (in the Personal section of the sidebar).
- On the Zoom tile (in Actions or Your actions), click Authenticate with OAuth.
- A popup opens to Zoom’s authorization page — review the requested scopes and click Allow.
- The popup closes and the Zoom tile now shows Authenticated status.
Step 9: Add Zoom to an agent
- Go to the Home page.
- Next to Agents, click + to create a new agent.
- Give the agent a name, drag the Zoom toolset onto the canvas, connect it to the Agent Core node with your model and chat input/output, then create the agent.
FAQ
What's the difference between Zoom Connector and Zoom Toolset?
What's the difference between Zoom Connector and Zoom Toolset?
| Aspect | Zoom Connector | Zoom Toolset |
|---|---|---|
| Purpose | Sync and index meetings, recordings, and transcripts for search | Enable agents to perform actions on Zoom |
| Data Flow | One-way (import data into PipesHub) | Two-way (read and write via API) |
| When to Use | Query/search past meetings, recordings, and transcripts | Schedule meetings, update recurring series, fetch transcripts on demand |
Why am I creating a 'General App' instead of an 'OAuth App'?
Why am I creating a 'General App' instead of an 'OAuth App'?
Zoom replaced the standalone “OAuth App” type with the General App type in 2024. General Apps support the same 3-legged OAuth flow plus additional capabilities. All new OAuth integrations should be built as General Apps — the old OAuth App type is considered legacy.
Do I need to publish the app on the Zoom Marketplace?
Do I need to publish the app on the Zoom Marketplace?
No. Keep the app unpublished (private) — it will only be usable by users within your own Zoom account, which is what you want for an internal integration. If you need to share the app with users in other Zoom accounts without publishing to the Marketplace, Zoom offers a Publishable URL approval process.
Usage Tips
How do I schedule a meeting?Ask your agent to “schedule a 30-minute Zoom meeting tomorrow at 3pm titled Design Review”. The agent picks the right timezone from your profile and returns the join URL. How do I schedule a recurring meeting?
Ask to “create a weekly standup every Monday at 10am for the next 12 weeks”. The agent configures the recurrence pattern automatically. How do I update just one occurrence of a recurring meeting?
Ask to “move next Monday’s standup to 11am without changing the rest of the series”. The agent updates only that occurrence. How do I fetch a meeting transcript?
Ask to “get the transcript from yesterday’s Product Review meeting”. The agent finds the meeting, retrieves the VTT transcript, and returns it as readable timestamped segments. How do I find my upcoming meetings?
Ask “what Zoom meetings do I have today?” or “list my Zoom calls this week”. The agent lists upcoming meetings with times and join links.