Setup Zoom Webhooks
AnthropicOfficialCreated by ZoomDistributed by Anthropic
- Skill
- Tool integration
- Automation and integrations
- MIT
- No issues found
AutoGineer summary
Written by AutoGineer from the skill’s own files, not by the author
This skill provides a technical reference for integrating Zoom webhooks into applications. It covers the essential steps for setting up event subscriptions, verifying incoming webhook signatures using HMAC, and handling event payloads. The documentation includes code examples for signature verification, a list of common event types, and links to community-maintained repositories for various programming languages.
What it does
- Provides code patterns for verifying Zoom webhook signatures using HMAC-SHA256.
- Lists common Zoom event types for meetings, recordings, users, and webinars.
- Outlines prerequisites for receiving webhooks, including HTTPS endpoints and secret tokens.
- Offers guidance on environment variable management for webhook secrets.
- Links to official and community-contributed sample implementations across multiple languages.
When to use it
- When setting up a new webhook listener for Zoom events.
- When implementing signature verification to secure your webhook endpoint.
- When troubleshooting issues with event delivery or payload parsing.
- When looking for language-specific examples of Zoom webhook handlers.
Advantages
- Centralizes essential configuration and security patterns for Zoom webhooks.
- Provides a clear, reusable code pattern for signature verification.
- Includes a comprehensive reference for event types and payload structures.
- Connects developers to a variety of community-tested implementation samples.
Usage examples
- “How do I verify a Zoom webhook signature in Node.js?”
- The skill provides an Express.js code snippet demonstrating how to capture the raw request body and use crypto.createHmac to validate the x-zm-signature header.
- “What events are available for Zoom recordings?”
- The skill lists recording-related events such as recording.started, recording.completed, and recording.trashed.
Install
Download the skill as a ZIP:
https://autogineer.com/agent-skills/anthropics/setup-zoom-webhooks/downloadUnzip it into the cross-client skills folder of your project:
mkdir -p .agents/skills && unzip setup-zoom-webhooks.zip -d .agents/skills
Documentation by Zoom
/setup-zoom-webhooks
Background reference for Zoom event delivery over HTTP. Prefer workflow skills first, then use this file for verification, subscription, and delivery details.
Prerequisites
Zoom app with Event Subscriptions enabled
HTTPS endpoint to receive webhooks
Webhook secret token for verification
Need help with authentication? See the zoom-oauth skill for OAuth setup.
Quick Start
// Express.js webhook handler
const crypto = require('crypto');
// Capture raw body for signature verification (avoid re-serializing JSON).
app.use(require('express').json({
verify: (req, _res, buf) => { req.rawBody = buf; }
}));
app.post('/webhook', (req, res) => {
// Verify webhook signature
const signature = req.headers['x-zm-signature'];
const timestamp = req.headers['x-zm-request-timestamp'];
const body = req.rawBody ? req.rawBody.toString('utf8') : JSON.stringify(req.body);
const payload = `v0:${timestamp}:${body}`;
const hash = crypto.createHmac('sha256', WEBHOOK_SECRET)
.update(payload).digest('hex');
if (signature !== `v0=${hash}`) {
return res.status(401).send('Invalid signature');
}
// Handle event
const { event, payload } = req.body;
console.log(`Received: ${event}`);
res.status(200).send();
});Common Events
| Event | Description |
|---|---|
meeting.started | Meeting has started |
meeting.ended | Meeting has ended |
meeting.participant_joined | Participant joined meeting |
recording.completed | Cloud recording ready |
user.created | New user added |
Detailed References
references/events.md - Complete event types reference
references/verification.md - Webhook URL validation
references/subscriptions.md - Event subscriptions API
Troubleshooting
RUNBOOK.md - 5-minute preflight checks before deep debugging
troubleshooting/common-issues.md - Signature verification, retries, URL validation
Sample Repositories
Official (by Zoom)
| Type | Repository | Stars |
|---|---|---|
| Node.js | webhook-sample | 34 |
| PostgreSQL | webhook-to-postgres | 5 |
| Go/Fiber | Go-Webhooks | - |
| Header Auth | zoom-webhook-verification-headers | - |
Community
| Language | Repository | Description |
|---|---|---|
| Laravel | binary-cats/laravel-webhooks | Laravel webhook handler |
| AWS Lambda | splunk/zoom-webhook-to-hec | Serverless to Splunk HEC |
| Node.js | Will4950/zoom-webhook-listener | Webhook forwarder |
| Express+Redis | ojusave/eventSubscriptionPlayground | Socket.io + Redis |
Multi-Language Samples (by tanchunsiong)
Full list: See general/references/community-repos.md
Resources
Webhook docs: https://developers.zoom.us/docs/api/webhooks/
Event reference: https://developers.zoom.us/docs/api/rest/reference/zoom-api/events/
Developer forum: https://devforum.zoom.us/
Environment Variables
See references/environment-variables.md for standardized
.envkeys and where to find each value.
Files
- ATTRIBUTION.mdAdded by AutoGineer983 B
- LICENSELicence file added by AutoGineer1.1 KiB
- RUNBOOK.md2.6 KiB
- SKILL.md5.0 KiB
- references/environment-variables.md642 B
- references/events.md1.9 KiB
- references/signature-verification.md161 B
- references/subscriptions.md7.2 KiB
- references/verification.md2.2 KiB
- troubleshooting/common-issues.md1.2 KiB
references/verification.md
Webhooks - Verification
Verify webhook authenticity and handle URL validation.
Overview
Zoom provides two verification mechanisms:
URL Validation - Verify your endpoint during setup
Request Signature - Verify each webhook request
URL Validation
When you configure a webhook endpoint, Zoom sends a validation request:
{
"event": "endpoint.url_validation",
"payload": {
"plainToken": "random_token_string"
}
}Response Required
Hash the token with your webhook secret and respond:
const crypto = require('crypto');
app.post('/webhook', (req, res) => {
const { event, payload } = req.body;
if (event === 'endpoint.url_validation') {
const hashForValidation = crypto
.createHmac('sha256', WEBHOOK_SECRET_TOKEN)
.update(payload.plainToken)
.digest('hex');
return res.json({
plainToken: payload.plainToken,
encryptedToken: hashForValidation
});
}
// Handle other events...
res.status(200).send();
});Request Signature Verification
Verify each webhook request is from Zoom:
Headers
| Header | Description |
|---|---|
x-zm-signature | Request signature |
x-zm-request-timestamp | Request timestamp |
Verification Code
const crypto = require('crypto');
function verifyWebhook(req) {
const signature = req.headers['x-zm-signature'];
const timestamp = req.headers['x-zm-request-timestamp'];
// Prefer raw body bytes captured by your framework to avoid JSON re-serialization mismatches.
const body = req.rawBody ? req.rawBody.toString('utf8') : JSON.stringify(req.body);
const message = `v0:${timestamp}:${body}`;
const hash = crypto
.createHmac('sha256', WEBHOOK_SECRET_TOKEN)
.update(message)
.digest('hex');
const expectedSignature = `v0=${hash}`;
return signature === expectedSignature;
}Security Best Practices
Always verify signatures
Check timestamp to prevent replay attacks
Use HTTPS endpoints only
Keep webhook secret secure
Resources
Webhook verification: https://developers.zoom.us/docs/api/rest/webhook-reference/#verify-webhook-events
Requirements and compatibility
Written for: Claude Code, Claude apps
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
- Anthropic (Official)
- Distributed by
- Anthropic
- Source
- anthropics/knowledge-work-plugins · partner-built/zoom-plugin/skills/webhooks · commit e050c2e
- Licence
- MIT License (redistribution allowed)
- LICENSE (added by AutoGineer from partner-built/zoom-plugin/LICENSE)
- ATTRIBUTION.md (written by AutoGineer)
- Synced
AutoGineer is not affiliated with or endorsed by Zoom or Anthropic.
Download ZIP
The ZIP holds the skill’s files, its licence files and an ATTRIBUTION.md. Download setup-zoom-webhooks.zip