Hookdeck Event Gateway Guides

Browse practical tutorials and implementation patterns for reliably receiving, sending, and routing webhooks with the Hookdeck Event Gateway.

General Guides

Core concepts and general how-tos for using Hookdeck effectively across various scenarios.

Connections Guide →

Learn how to create and configure Hookdeck Connections to route webhook events between services, with best practices for Sources, Destinations, and processing rules.

Control Throughput →

Use Hookdeck's rate limiting and queuing to control event flow and protect your destinations.

Decode and Verify JWTs →

Read the claims of a JSON Web Token sent with a request, verify its signature and expiry with Node.js crypto or jose, and filter out requests with invalid tokens.

Decompress Gzip & Zip Payloads →

Turn gzip-compressed requests and zip archives into JSON events with node:zlib, and compress payloads before delivery.

Extract Data from a PDF →

Turn application/pdf requests into JSON events by extracting text, invoice fields, and document metadata in a transformation with bundled npm libraries.

Generate an Image from Text →

Turn a JSON request into a PNG image with a dependency-free transformation, and deliver it to your destination as an image/png payload.

Multipart Requests →

Learn how Hookdeck handles multipart/form-data requests, including form fields, files, previews, search, filters, and transformations.

Filter & Route Events →

Learn how to use Hookdeck's filtering capabilities to remove unwanted events and conditionally route data to specific destinations.

Observability of Event Flows →

A guide to understanding and utilizing Hookdeck's observability features to monitor, debug, and manage your event-driven architecture, regardless of the use case.

Order Transformations & Filters →

Control whether transformations run before or after filters to simplify logic, avoid unnecessary processing, and clean up filter-only data.

Avoid Webhook DDoS →

Learn how to set up a rate limit for a Destination in Hookdeck. Benefit from a throttled delivery to control the pace your server receives webhooks. Avoid losing webhooks because your server crashed handling a webhook spike.

Whitelist Hookdeck in Cloudflare →

Guide of the steps required to make Hookdeck and Cloudflare bot protection work together.

Fan-In Webhooks →

Consolidate webhooks from multiple platforms into a single endpoint and normalize disparate data payloads using Hookdeck transformations.

CLI Connection Management →

Learn how to manage webhook connections programmatically using the Hookdeck CLI for Infrastructure as Code, CI/CD integration, and production workflows.

Manage Environments →

Utilize Hookdeck Projects to segregate configurations for development, staging, and production.

Migrate Multipart Handling →

Learn how Hookdeck handles multipart/form-data requests, what changed, and how to move a connection from legacy string handling to binary-safe handling.

PagerDuty Integration →

Use the Hookdeck PagerDuty integration to integrate Hookdeck Issues with your PagerDuty workflows

Pause & Resume Connections →

Learn how to temporarily pause and resume connections to manage maintenance, handle endpoint downtime, or control event flow without losing data.

Sentry Integration →

Use the Hookdeck Sentry integration to track Hookdeck Issues as Sentry issues and keep their status in sync

Transform Content-Type →

Learn how to convert event payload content types, such as application/x-www-form-urlencoded to application/json, using Hookdeck transformations.

Transform File Uploads →

Read, replace, add, and remove files in multipart/form-data requests with a transformation, such as converting an uploaded CSV file to JSON.

Receiving Webhooks

Learn how to reliably ingest, queue, and manage webhooks from third-party services.

Deduplication Patterns →

Learn how to implement webhook deduplication strategies for real-world scenarios like Shopify product updates and Stripe payment retries.

Handling Thin Events →

Learn how Hookdeck's Event Gateway solves the operational challenges of the thin events pattern at scale, including API rate limiting, event deduplication, and payload transformation.

Fan Out Webhooks →

Learn how to use Hookdeck to fan out webhooks to different services.

Receive a Webhook →

How to use the Hookdeck UI and API to receive a webhook to an HTTP endpoint (URL).

Test Webhooks Locally →

Learn how to use the Hookdeck CLI to create a secure tunnel, forwarding webhooks from a public Hookdeck Event Gateway URL directly to your local development server for rapid testing and debugging.

MCP Events Forward Proxy →

Receive MCP Events through Event Gateway: an MCP Events source answers the handshake, verifies each delivery, and a connection delivers it to your agent.

Verify Incoming Webhooks →

Secure your endpoints by verifying the signatures of incoming webhooks using Hookdeck. Learn to configure Hookdeck for source verification or pass through signatures for application-level checks.

Third-Party Event Routing

Connect different third-party services by routing events between them using Hookdeck as an intermediary.