Zoom General

From the author

Use when comparing products.

— the description by Zoom

AutoGineer summary

Written by AutoGineer from the skill’s own files, not by the author

Zoom General serves as a strategic starting point for developers and architects to navigate the Zoom ecosystem. It provides a structured workflow to classify integration requirements, identify the correct Zoom product surface (such as APIs, SDKs, or webhooks), and determine the necessary authentication model. By guiding users through a decision-making process, it ensures that developers select the right tool for their specific use case before routing to more specialized skills.

What it does

Classifies integration jobs based on desired outcomes like embedding meetings or automating resources.
Maps requirements to specific Zoom surfaces including REST APIs, WebSockets, and various SDKs.
Provides guidance on selecting the correct authentication and scope model for an integration.
Facilitates routing to specialized skills once the product context is established.
Offers comparative context for tasks that span multiple Zoom product boundaries.

When to use it

When you are in the early stages of planning a Zoom integration and need to choose the right app type.
When you need to compare different Zoom surfaces to determine which fits your technical requirements.
When a task involves multiple Zoom products and requires a high-level architectural approach.
When you need to confirm the correct authentication flow for a specific integration scenario.

Advantages

Prevents premature selection of tools by enforcing a structured classification process.
Clarifies the distinction between user-level OAuth, account-level OAuth, and SDK signatures.
Reduces complexity by routing users to narrow, specialized skills after initial planning.
Provides a clear decision matrix for choosing between General Apps, Server-to-Server OAuth, and Webhook Only apps.

Usage examples

“I want to build an app that automates meeting reports. Which Zoom app type should I use?”: The agent will guide you to classify the job as backend automation, leading to the recommendation of Server-to-Server OAuth for its lack of user interaction requirements.
“Should I use the Meeting SDK or the Video SDK for my project?”: The agent will help you compare the two based on your specific embedding needs and surface requirements, ensuring you choose the correct SDK for your use case.

Install

Download the skill as a ZIP:
https://mp-staging.autogineer.com/agent-skills/openai/zoom-general/download

Unzip it into the cross-client skills folder of your project:

mkdir -p .agents/skills && unzip zoom-general.zip -d .agents/skills

Documentation by Zoom

Use this skill for cross-product platform context after the user’s goal is understood. For first-step routing, prefer start, plan-zoom-product, or plan-zoom-integration.

Workflow

Classify the job by outcome: embed meetings, custom video, automate resources, consume events, process media, use meeting intelligence, or publish a Marketplace app.
Choose the Zoom surface that owns the behavior: REST API, webhooks, WebSockets, Meeting SDK, Video SDK, Zoom Apps SDK, Phone, Contact Center, Virtual Agent, Scribe, Rivet, or Cobrowse.
Confirm auth and scope model before implementation; Zoom surfaces differ on user-level OAuth, account-level OAuth, and SDK signatures.
Route to the narrow skill once the surface is chosen rather than keeping broad guidance in context.
Use the preserved guide only when a task crosses product boundaries or needs detailed comparison tables.

References

Full preserved guide: references/full-guide.md
App types: references/app-types.md
Authentication: references/authentication.md
Scopes: references/scopes.md
Marketplace: references/marketplace.md
Query routing playbook: references/query-routing-playbook.md

Files

ATTRIBUTION.mdAdded by AutoGineer866 B
LICENSELicence file added by AutoGineer1.1 KiB
RUNBOOK.md2.4 KiB
SKILL.md1.4 KiB
agents/openai.yaml133 B
references/app-types.md2.6 KiB
references/authentication.md2.0 KiB
references/authorization-patterns.md21.2 KiB
references/automatic-skill-chaining-rest-webhooks.md5.5 KiB
references/community-repos.md9.1 KiB
references/distributed-meeting-fallback-architecture.md14.0 KiB
references/environment-variables.md3.0 KiB
references/full-guide.md5.3 KiB
references/interview-answer-routing.md796 B
references/known-limitations.md2.5 KiB
references/marketplace.md1.6 KiB
references/meeting-webhooks-oauth-refresh-orchestration.md5.3 KiB
references/query-routing-playbook.md2.7 KiB
references/routing-implementation.md3.7 KiB
references/scopes.md3.4 KiB
references/sdk-logs-troubleshooting.md5.7 KiB
references/sdk-upgrade-guide.md4.1 KiB
references/sdk-upgrade-workflow.md3.5 KiB
use-cases/ai-companion-integration.md9.8 KiB
use-cases/ai-integration.md7.2 KiB
use-cases/backend-automation-s2s-oauth.md4.9 KiB
use-cases/collaborative-apps.md2.6 KiB
use-cases/contact-center-app-lifecycle-and-context-switching.md1.2 KiB
use-cases/contact-center-integration.md1.1 KiB
use-cases/custom-meeting-ui-web.md2.8 KiB
use-cases/custom-video.md5.6 KiB
use-cases/customer-support-cobrowsing.md12.5 KiB
use-cases/electron-meeting-embed.md1020 B
use-cases/embed-meetings.md4.8 KiB
use-cases/enterprise-app-deployment.md1.0 KiB
use-cases/flutter-video-sessions.md910 B
use-cases/form-completion-assistant.md15.3 KiB
use-cases/hd-video-resolution.md8.8 KiB
use-cases/high-volume-meeting-platform.md1.9 KiB
use-cases/immersive-experiences.md2.9 KiB
use-cases/in-meeting-apps.md7.4 KiB
use-cases/marketplace-publishing.md9.2 KiB
use-cases/meeting-automation.md6.1 KiB
use-cases/meeting-bots.md10.6 KiB
use-cases/meeting-details-with-events.md20.8 KiB
use-cases/meeting-links-vs-embedding.md988 B
use-cases/minutes-calculation.md22.5 KiB
use-cases/native-meeting-sdk-multi-platform.md1.5 KiB
use-cases/native-video-sdk-multi-platform.md1.2 KiB
use-cases/prebuilt-video-ui.md12.4 KiB
use-cases/probe-sdk-preflight-readiness-gate.md1.2 KiB
use-cases/qss-monitoring.md2.7 KiB
use-cases/raw-recording.md5.1 KiB
use-cases/react-native-meeting-embed.md1.0 KiB
use-cases/react-native-video-sessions.md953 B
use-cases/real-time-media-streams.md5.4 KiB
use-cases/recording-download-pipeline.md8.7 KiB
use-cases/recording-transcription.md7.2 KiB
use-cases/retrieve-meeting-and-subscribe-events.md32.9 KiB
use-cases/rivet-event-driven-api-orchestrator.md1.3 KiB
use-cases/saas-app-oauth-integration.md4.8 KiB
use-cases/scribe-transcription-pipeline.md1.8 KiB
use-cases/sdk-size-optimization.md5.0 KiB
use-cases/sdk-wrappers-gui.md18.4 KiB
use-cases/server-to-server-oauth-with-webhooks.md1.7 KiB
use-cases/team-chat-llm-bot.md6.7 KiB
use-cases/testing-development.md7.2 KiB
use-cases/token-and-scope-troubleshooting.md2.4 KiB
use-cases/transcription-bot-linux.md14.3 KiB
use-cases/usage-reporting-analytics.md8.5 KiB
use-cases/user-and-meeting-creation.md16.9 KiB
use-cases/video-sdk-bring-your-own-storage.md6.9 KiB
use-cases/virtual-agent-campaign-web-mobile-wrapper.md1.4 KiB
use-cases/virtual-agent-knowledge-base-sync-pipeline.md1.1 KiB
use-cases/web-sdk-embedding.md4.5 KiB
use-cases/zoom-phone-smart-embed-crm.md876 B

use-cases/token-and-scope-troubleshooting.md

Token and Scope Troubleshooting (Highest-Frequency Pattern)

This is the most common failure mode across Zoom REST API integrations and SDK backends:

Invalid access token
Access token is expired
does not contain scopes:[...]
"works for me but not for other users/accounts"

Skills Needed

Order	Skill	Purpose
1	zoom-oauth	Understand which grant type you are using and why
2	zoom-rest-api	Tie the failing endpoint to required scopes and app type
3	zoom-webhooks (optional)	Verify you are validating webhook requests correctly

Triage Checklist

1. Identify Which Token You Are Using

Ask:

Which app type: Server-to-Server OAuth, General App (User OAuth), Chatbot, Meeting SDK, Video SDK?
Which token: user OAuth access token, S2S OAuth access token, bot token, SDK JWT?

Rule of thumb:

REST calls generally require OAuth access tokens (S2S or user-based depending on endpoint).
SDK join flows require SDK JWT/signature plus product-specific tokens (for some cases).

2. Confirm the Exact Endpoint and Operation

Token scope errors are endpoint-specific. Capture:

HTTP method + path (example: GET /v2/users/me/token?type=zak)
full error response body from Zoom
the token’s scope string (if present in token response)

3. Map Endpoint -> Required Scopes

Do not guess scopes.

Use zoom-rest-api references for the endpoint.
Use general/references/authorization-patterns.md for RBAC and scope validation strategies.

If you add scopes after users already installed/authorized:

existing users may need to reauthorize so the new scopes are granted

5. “Works on My Account” Usually Means One of These

different account plan/features enabled
missing admin role / privilege
endpoint requires :admin scope but token only has user scope
using the wrong me semantics for the app type

Common Fix Patterns

Add missing scopes, then reauthorize users (User OAuth).
Ensure you are using the correct grant (S2S for backend automation across an account; User OAuth when acting on behalf of users).
Validate that the endpoint actually supports your app type (some endpoints are not usable with some token types).

Links

../references/authorization-patterns.md
../../rest-api/troubleshooting/token-scope-playbook.md
../../oauth/SKILL.md

Requirements and compatibility

Written for: OpenAI Codex

Works with: Claude Code, Claude apps, OpenAI Codex, GitHub Copilot, Cursor, Gemini CLI, Kiro, OpenCode, Goose, Amp, Roo Code, JetBrains Junie, Factory Droid, Devin (ex-Windsurf), Mistral Vibe, OpenHands, Letta

“Works with” means the tool reads the open Agent Skills format; a skill written for one tool may use features others lack.

Security

What our scanner noticed· Medium risk

Possible data-exfiltration endpoints
Instructions that use the network

A static scan is not a guarantee. Skills are third-party content: review a skill before you let an agent use it.

Build MCP App
AnthropicOfficial
Build interactive UI widgets for MCP servers to render forms, pickers, and dashboards directly within the chat interface.
Automation and integrationsClaude CodeClaude appsOpenAI Codex+14 more
Apache-2.0GitHub stars of the source repository46.3k
MCP Integration
AnthropicOfficial
Comprehensive guide for integrating Model Context Protocol (MCP) servers into Claude Code plugins.
Automation and integrationsClaude CodeClaude appsOpenAI Codex+14 more
Apache-2.0GitHub stars of the source repository46.3k
Social Publishing
Seth Hobson· Community
Programmatically schedule and publish content across 13 social media platforms using the SocialClaw API.
Automation and integrationsClaude CodeClaude appsOpenAI Codex+14 more
MITGitHub stars of the source repository42.3k
Hermes Tweet
Seth Hobson· Community
Integrates X/Twitter research and action capabilities into the Hermes Agent framework with strict approval-gated security.
Automation and integrationsClaude CodeClaude appsOpenAI Codex+14 more
MITGitHub stars of the source repository42.3k
Paypal Integration
Seth Hobson· Community
A guide to integrating PayPal payment processing, including checkout flows, subscriptions, and IPN webhook handling.
Automation and integrationsClaude CodeClaude appsOpenAI Codex+14 more
MITGitHub stars of the source repository42.3k
Social Publishing Publisher
Seth Hobson· Community
An agent-driven social media publishing specialist for multi-platform campaign management via the SocialClaw API.
Automation and integrationsClaude Code
MITGitHub stars of the source repository42.3k

Download ZIP

The ZIP holds the skill’s files, its licence files and an ATTRIBUTION.md. Download zoom-general.zip