AutoGineer
Generated banner for Build Zoom Meeting SDK App
Generated logo for Build Zoom Meeting SDK App

Build Zoom Meeting SDK App

OpenAIOfficialCreated by ZoomDistributed by OpenAI

  • Skill
  • Tool integration
  • Software development
  • MIT
  • No issues found
Download ZIP

From the author

Use when using Meeting SDK.
— the description by Zoom

AutoGineer summary

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

This skill provides a structured workflow for developers integrating the Zoom Meeting SDK into their applications. It covers the lifecycle of a meeting integration, from initial product validation and platform selection to implementation and debugging. It emphasizes the distinction between the Meeting SDK, which is designed for human-led meetings, and other Zoom SDKs, while providing guidance on handling signatures, user identity, and meeting controls.

What it does

  • Guides developers through the integration of the Zoom Meeting SDK for web, mobile, and desktop platforms.
  • Provides a systematic workflow for joining and starting meetings.
  • Offers troubleshooting strategies for common issues like signature generation and permission errors.
  • Includes references for platform-specific implementations and AI Companion feature management.
  • Helps validate meeting parameters such as meeting numbers, passwords, and ZAK tokens.

When to use it

  • When you need to embed real Zoom meetings into your application.
  • When you are setting up a new Zoom Meeting SDK project for web, Android, iOS, or desktop.
  • When you encounter errors during the meeting join flow or signature validation.
  • When you need to manage AI Companion features within an embedded meeting context.

Advantages

  • Provides a clear, step-by-step path for successful SDK integration.
  • Centralizes access to platform-specific documentation and troubleshooting resources.
  • Helps distinguish between different Zoom SDK capabilities to ensure the right tool is used.
  • Includes a dedicated signature playbook to resolve common authentication failures.

Usage examples

“How do I start integrating the Zoom Meeting SDK for an Android app?”
The agent will guide you through verifying your environment, choosing the default UI for initial testing, and using the Android-specific reference pointers to resolve dependencies.
“I am getting an invalid signature error when trying to join a meeting.”
The agent will direct you to the signature playbook to verify your SDK signature generation logic and parameter matching.
“Can I use the Meeting SDK to build an automated AI notetaker bot?”
The agent will clarify that the Meeting SDK is for human use cases only and recommend using rtms for automated AI processing.

Install

  1. Download the skill as a ZIP:

    https://mp-staging.autogineer.com/agent-skills/openai/build-zoom-meeting-sdk-app/download

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

    mkdir -p .agents/skills && unzip build-zoom-meeting-sdk-app.zip -d .agents/skills

Documentation by Zoom

Build Zoom Meeting SDK App

Use this skill when the user needs to join, start, or embed real Zoom meetings. If the user wants a fully custom non-meeting video experience, route to build-zoom-video-sdk-app.

Workflow

  1. Confirm product fit: Meeting SDK joins real Zoom meetings; Video SDK creates custom sessions; Zoom Apps SDK runs inside the Zoom client.

  2. Choose the target platform: web, Android, iOS, macOS, Windows, Electron, React Native, Unreal, or Linux bot.

  3. Validate the join or start path: meeting number, password, SDK signature, role, ZAK when hosting, waiting room behavior, and user identity.

  4. Implement the smallest join flow first, then add meeting controls, custom UI, raw data, recording, or bot behavior.

  5. Debug by isolating signature generation, SDK version, platform permissions, meeting settings, waiting room, raw data entitlement, and network constraints.

References

Files

references/signature-playbook.md

title: "Meeting SDK Signature Playbook"

Meeting SDK Signature Playbook

Most “join failed” issues reduce to signature generation or mismatched inputs.

Rules

  1. Generate signatures server-side only. Never ship the SDK Secret to the browser/app.

  2. meetingNumber must be digits only.

  3. role must match what you are doing:

    • 0 = join as attendee

    • 1 = start as host

  4. Keep iat/exp reasonable and account for clock skew (server time matters).

Required Payload Fields (Common Pattern)

You’ll typically see fields like:

  • sdkKey

  • mn (meeting number)

  • role

  • iat, exp, tokenExp

If the developer is mixing in REST API OAuth tokens or Marketplace JWT app-type tokens, stop and clarify: those are not Meeting SDK signatures.

Common Failure Modes

  • Invalid signature:

    • wrong secret

    • wrong mn format

    • expired exp/tokenExp

    • generating signature for role=1 but joining (or vice versa)

  • 4003 Invalid Parameter (common on Web “start” flows):

    • role mismatch or missing host requirements (often needs ZAK for host start flows)

  • Works locally but not in prod:

    • different env vars/secret

    • prod server clock skew

Web-Specific Gotcha: passWord

On Web Client View (ZoomMtg.join) the key is passWord (capital W). If the meeting has a passcode and it’s missing/misnamed, join fails in a way that looks like auth trouble.

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

No issues found by our static scan· No issues found

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

Attribution and licence

Created by
Zoom
Publisher
OpenAI (Official)
Distributed by
OpenAI
Source
openai/plugins · plugins/zoom/skills/meeting-sdk · commit d420d13
Licence
MIT License (redistribution allowed)
  • LICENSE (added by AutoGineer from plugins/zoom/LICENSE)
  • ATTRIBUTION.md (written by AutoGineer)
Synced

AutoGineer is not affiliated with or endorsed by Zoom or OpenAI.

Download ZIP

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