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.