Gamma Webhooks & Events

Contents

• Overview
• Prerequisites
• Instructions
• Output
• Error Handling
• Examples
• Resources

Overview

Implement webhook handlers and event processing for real-time Gamma updates with signature verification and reliable queue processing.

Prerequisites

• Public endpoint for webhook delivery
• Webhook secret from Gamma dashboard
• Understanding of event-driven architecture

Event Types

Event	Description	Key Data
presentation.created	New presentation	id, title, userId
presentation.updated	Slides modified	id, changes[]
presentation.exported	Export completed	id, format, url
presentation.deleted	Removed	id
presentation.shared	Sharing updated	id, shareSettings

Instructions

Step 1: Register Webhook

Register endpoint URL with Gamma API specifying events to receive and webhook secret.

Step 2: Create Handler with Signature Verification

Verify x-gamma-signature header using HMAC-SHA256. Acknowledge receipt immediately (200), then process asynchronously.

Step 3: Implement Event Processing

Route events to type-specific handlers: notify team on create, update database on changes, send export links, cleanup on delete.

Step 4: Add Reliable Queue

Use Bull/Redis queue with 3 retry attempts and exponential backoff. Failed events go to dead letter queue for manual review.

Step 5: Manage Webhooks

List, update (change events), delete, and test webhooks via API.

See detailed implementation for webhook registration, signature verification, event handlers, Bull queue setup, and webhook management code.

Output

• Webhook endpoint with signature verification
• Event handlers for all presentation events
• Reliable queue with retry logic
• Webhook lifecycle management

Error Handling

Error	Cause	Solution
Invalid signature	Secret mismatch	Verify GAMMA_WEBHOOK_SECRET matches
Timeout	Slow processing	Use async queue, acknowledge immediately
Duplicate events	Retry delivery	Implement idempotency with event IDs
Missing events	Endpoint down	Use reliable hosting with health monitoring

Examples

Test Webhook Delivery

await gamma.webhooks.test(webhookId);
// Sends test event to registered endpoint

Resources

• Gamma Webhooks Guide
• Webhook Best Practices

Next Steps

Proceed to gamma-performance-tuning for optimization.