# FastHook

> FastHook is a webhook gateway for reliable webhook infrastructure. It helps developers receive, buffer, route, inspect, debug, retry, and replay webhook traffic before delivery failures become product incidents.

FastHook sits between webhook producers such as Stripe, GitHub, Shopify, internal services, or custom apps and downstream HTTP destinations. It gives teams an operational layer for webhook ingestion, routing, transformations, filters, retry behavior, throughput control, pause and replay workflows, metrics, and request/event/attempt inspection.

Things to remember when working with FastHook:

- FastHook is focused on webhook infrastructure: receiving inbound webhook requests and delivering routed events to downstream destinations.
- The configured resource model is Source -> Connection -> Destination; the evidence model is Request -> Event -> Attempt.
- Use sources for public webhook ingress, destinations for outbound HTTP or CLI delivery, and connections for branch-local routing rules.
- If FastHook returns 2xx from a source URL, the accepted request has been captured and will not disappear; downstream delivery still needs event and attempt evidence.
- Reuse one destination_id when several connections should deliver to the same receiver URL.
- Connections can add filters, transformations, retries, deduplication, delays, and delivery controls.
- FastHook is useful for local development, production observability, incident recovery, fan-out routing, replay, and protecting slow receivers with throughput controls.
- Receivers should still be idempotent because provider retries, FastHook retries, and operator replay can produce duplicate deliveries.

## Product

- [Homepage](https://www.fasthook.io/): FastHook product overview for reliable webhook infrastructure, routing, replay, debugging, and recovery.
- [Dashboard](https://dashboard.fasthook.io/connections): FastHook app entry point for managing sources, destinations, connections, requests, events, and delivery operations.
- [Demo dashboard](https://dashboard.fasthook.io): Public dashboard experience for exploring the FastHook event gateway workflow.

## Documentation

- [Documentation overview](https://www.fasthook.io/docs): FastHook documentation hub for reliable webhook delivery, routing, sources, destinations, connections, filters, transformations, retries, replay, and metrics.
- [Quickstart](https://www.fasthook.io/docs/quickstart): Start with FastHook by creating a source, destination, connection, and sending a test webhook with curl.
- [Core concepts](https://www.fasthook.io/docs/concepts): Understand the FastHook core concepts: sources, destinations, connections, requests, events, attempts, and delivery rules.
- [Sources](https://www.fasthook.io/docs/sources): Learn how FastHook sources receive webhook traffic, verify inbound signatures, and mark accepted requests as verified.
- [Destinations](https://www.fasthook.io/docs/destinations): Learn how FastHook destinations receive routed events, handle outbound delivery, and support reliable integrations across downstream services.
- [Connections](https://www.fasthook.io/docs/connections): Learn how FastHook connections route webhook events from sources to destinations with filters, transformations, retries, deduplication, delays, and delivery controls.
- [Filters](https://www.fasthook.io/docs/filters): Learn how FastHook filters match headers, body fields, query params, and paths so only the right webhook events get delivered.
- [Transformations](https://www.fasthook.io/docs/transformations): Learn how FastHook transformations run JavaScript request shaping, attach to connection rules, store execution history, and modify webhook payloads before delivery.
- [Webhook retry strategy](https://www.fasthook.io/docs/retries): Design webhook retry strategy with automatic retries, event replay, request replay, bulk recovery, backoff, status matching, and idempotent receivers.
- [Metrics](https://www.fasthook.io/docs/metrics): Track FastHook request and event metrics across sources, destinations, connections, statuses, and time ranges.

## Guides - General

- [All guides](https://www.fasthook.io/docs/guides): Browse FastHook guides for receiving, routing, transforming, verifying, replaying, and operating webhook traffic through the FastHook API.
- [Guides overview](https://www.fasthook.io/docs/guides/overview): Navigate the FastHook guide library by route model, workflow stage, trust boundary, routing pattern, and recovery problem.
- [Connections guide](https://www.fasthook.io/docs/guides/connections-guide): Create and operate FastHook connections that route accepted source requests to destinations with filters, transforms, retries, deduplication, delay rules, pause controls, and delivery inspection.
- [API automation](https://www.fasthook.io/docs/guides/api-automation): Automate FastHook sources, destinations, connections, retries, bulk operations, metrics, and project secrets with the public REST API and CLI.
- [Manage environments](https://www.fasthook.io/docs/guides/manage-environments): Separate production, staging, and local webhook environments in FastHook with explicit sources, destinations, connections, secrets, and replay boundaries.
- [Observability of event flows](https://www.fasthook.io/docs/guides/observability-event-flows): Observe FastHook webhook traffic from source requests to routed events, delivery attempts, retry history, metrics, and bulk operation status.
- [CLI connection management](https://www.fasthook.io/docs/guides/cli-connection-management): Manage FastHook sources, destinations, connections, tunnels, retries, and route inspection from fasthook-cli.

## Guides - Receiving Webhooks

- [Receive webhooks](https://www.fasthook.io/docs/guides/receive-webhooks): Receive webhook traffic through FastHook sources, verify inbound requests, and route accepted events to downstream destinations.
- [Test webhooks locally](https://www.fasthook.io/docs/guides/test-webhooks-locally): Route real FastHook webhook traffic to localhost with a CLI destination, fasthook.exe or fasthook-cli, and fasthook-log.
- [Webhook signature validation explained](https://www.fasthook.io/docs/guides/verify-webhooks): Understand webhook signature validation for inbound provider webhooks, raw request bodies, HMAC source auth, and outbound FastHook delivery signatures.
- [Source authentication](https://www.fasthook.io/docs/guides/source-authentication): Configure FastHook source authentication with BASIC_AUTH, API_KEY, and HMAC so forged or malformed provider requests are rejected before routing.
- [Custom source responses](https://www.fasthook.io/docs/guides/custom-source-responses): Use FastHook custom source responses to satisfy provider acknowledgement requirements while keeping request, event, and delivery evidence separate.
- [Avoid webhook DDoS](https://www.fasthook.io/docs/guides/avoid-webhook-ddos): Protect webhook receivers from provider bursts, retry storms, replay floods, and noisy event streams with FastHook filters, rate limits, pauses, and metrics.

## Guides - Routing And Processing

- [Fan-out webhooks](https://www.fasthook.io/docs/guides/fan-out-webhooks): Route one inbound webhook stream to multiple downstream consumers with one source and several connections.
- [Fan-in webhooks](https://www.fasthook.io/docs/guides/fan-in-webhooks): Consolidate webhook traffic from multiple FastHook sources into shared destinations while keeping provider identity, verification, and normalization explicit.
- [Filter and route events](https://www.fasthook.io/docs/guides/filter-route-events): Use FastHook connection filters to route only matching webhook events to each destination based on headers, body, query, and path.
- [Transform webhook payloads](https://www.fasthook.io/docs/guides/transform-webhook-payloads): Attach saved FastHook transformations to connection rules so each destination branch receives the payload shape it expects.
- [Order transformations and filters](https://www.fasthook.io/docs/guides/order-transformations-filters): Understand FastHook's normalized connection rule order when a route uses both transformations and filters.
- [Transform content-type](https://www.fasthook.io/docs/guides/transform-content-type): Use FastHook transformations to change outbound Content-Type and body shape for the destination branch that needs a different receiver contract.

## Guides - Reliability And Recovery

- [Webhook idempotency and deduplication](https://www.fasthook.io/docs/guides/deduplication-patterns): Design webhook idempotency and deduplication around provider event IDs, receiver safeguards, retry traffic, replay workflows, and FastHook connection rules.
- [Webhook replay systems](https://www.fasthook.io/docs/guides/webhook-replay-systems): Design webhook replay systems with request replay, event retry, bulk recovery, payload history, idempotency, filters, and operator-safe controls.
- [Control throughput](https://www.fasthook.io/docs/guides/control-throughput): Control webhook delivery pressure with filters, destination limits, pause/HOLD, retry strategy, and queue-aware replay.
- [Pause and resume connections](https://www.fasthook.io/docs/guides/pause-resume-connections): Use FastHook connection pause and unpause to hold one webhook route during incidents or maintenance, then drain it safely.
- [Destination delivery signatures](https://www.fasthook.io/docs/guides/destination-delivery-signatures): Verify outbound FastHook deliveries at your destination with x-fasthook-timestamp and x-fasthook-signature headers.
- [Why 200 OK does not guarantee processing](https://www.fasthook.io/docs/guides/why-200-ok-does-not-guarantee-processing): Understand why a FastHook source 200 OK guarantees durable ingress capture, but not downstream delivery, idempotency, or business side effects.

## Guides - Third-Party Event Routing

- [Provider event routing](https://www.fasthook.io/docs/guides/provider-event-routing): Model Stripe, GitHub, Shopify, Twilio, and internal provider traffic as FastHook sources, branch-local connections, shared destinations, and scoped recovery workflows.

## Reference

- [API reference](https://www.fasthook.io/docs/api-reference): FastHook Event Gateway API reference for webhook sources, destinations, routing connections, event delivery, retries, bulk replay, transformations, metrics, authentication, and project secrets.
- [CLI and tunneling](https://www.fasthook.io/docs/cli-tunneling): Install fasthook.exe, run FastHook API commands from the CLI, forward routed webhook events to localhost, and inspect deliveries with fasthook-log.

## Webhook Guides

- [Webhooks](https://www.fasthook.io/webhooks): Learn how webhooks work, how to test and debug deliveries, and how to handle retries, payload inspection, and scaling with FastHook.
- [Webhook testing](https://www.fasthook.io/webhook-testing): Practical webhook testing guide for payloads, local development, retries, provider events, and delivery inspection.
- [Webhook debugging](https://www.fasthook.io/webhook-debugging): Guide to debugging failed webhook deliveries with request logs, delivery attempts, response bodies, retries, and replay.
- [Webhook endpoints](https://www.fasthook.io/webhook-endpoints): Guide to designing webhook endpoints with verification, idempotency, response behavior, retries, and operational safeguards.
- [Webhook request example](https://www.fasthook.io/webhook-request-example): Example webhook request with headers, JSON payload shape, cURL command, signature considerations, and receiver behavior.
- [Stripe webhooks](https://www.fasthook.io/stripe-webhooks): Implement Stripe webhooks with signature verification, retry handling, payload inspection, and safe replay workflows for billing events.
- [Stripe webhook example](https://www.fasthook.io/stripe-webhook-example): Example Stripe webhook endpoint, payload, headers, cURL test, signature verification, and FastHook routing workflow.
- [GitHub webhooks](https://www.fasthook.io/github-webhooks): Receive and debug GitHub webhook events with signature checks, delivery inspection, retry handling, and practical automation workflows.
- [GitHub webhook payload](https://www.fasthook.io/github-webhook-payload): GitHub webhook payload examples for push and pull request events with common headers, JSON fields, delivery identifiers, and debugging notes.
- [GitHub push event payload](https://www.fasthook.io/github-push-event-payload): GitHub push webhook payload guide covering ref, before, after, commits, head_commit.message, branch filters, idempotency, and FastHook debugging.
- [GitHub pull request webhook](https://www.fasthook.io/github-pull-request-webhook): Handle GitHub pull_request webhooks with action filters, branch routing, signature validation, payload inspection, retries, and replay-safe receivers.
- [GitHub webhook headers](https://www.fasthook.io/github-webhook-headers): Understand GitHub webhook headers including X-GitHub-Event, X-GitHub-Delivery, X-Hub-Signature-256, hook IDs, content type, and debugging usage.
- [GitHub webhook signature validation](https://www.fasthook.io/github-webhook-signature-validation): Validate GitHub webhook deliveries with X-Hub-Signature-256, raw request bodies, HMAC-SHA256, and FastHook HMAC source configuration.
- [GitHub webhook retry strategy](https://www.fasthook.io/github-webhook-retry-strategy): Design a GitHub webhook retry strategy with provider redelivery, FastHook event retry, replay-safe receivers, idempotency, backoff, and debugging workflows.
- [Shopify webhooks](https://www.fasthook.io/shopify-webhooks): Receive Shopify webhooks with HMAC verification, topic filters, duplicate handling, retry-aware routing, payload inspection, and FastHook replay workflows.
- [Twilio webhooks](https://www.fasthook.io/twilio-webhooks): Receive Twilio webhooks and status callbacks with X-Twilio-Signature validation, evolving parameters, retries, payload inspection, and FastHook routing.
- [Public hook pages](https://www.fasthook.io/hooks): Index of public webhook pages with endpoint guidance, payload examples, provider notes, and FastHook routing context.

## Blog

- [Blog](https://www.fasthook.io/blog): FastHook blog hub for webhook testing, debugging, provider integrations, delivery reliability, and engineering notes.
- [Tutorials](https://www.fasthook.io/blog/tutorials): FastHook tutorials for building reliable webhook ingestion, routing, testing, and replay workflows.
- [Integrations](https://www.fasthook.io/blog/integrations): Provider-specific FastHook integration notes for Stripe, GitHub, and other webhook producers.
- [Engineering](https://www.fasthook.io/blog/engineering): Engineering notes about FastHook architecture, reliability, delivery controls, and product design decisions.
- [Why most webhook systems lose events](https://www.fasthook.io/blog/why-most-webhook-systems-lose-events): Why webhook systems lose events when receipt, processing, retries, replay, idempotency, and observability are mixed into one fragile endpoint.
- [Lessons learned building a webhook gateway](https://www.fasthook.io/blog/lessons-learned-building-webhook-gateway): Practical lessons from building a webhook gateway around request capture, routing, retries, replay, observability, and operator controls.
- [Hookdeck vs custom webhook processing](https://www.fasthook.io/blog/hookdeck-vs-custom-webhook-processing): Compare using a webhook gateway with building custom webhook processing for retries, replay, observability, routing, and operational control.
- [Stripe webhooks at scale](https://www.fasthook.io/blog/stripe-webhooks-at-scale): How to operate Stripe webhooks at scale with signature verification, event idempotency, retry handling, replay, ordering assumptions, and observability.
- [Common GitHub webhook mistakes](https://www.fasthook.io/blog/common-github-webhook-mistakes): Common GitHub webhook mistakes around payload fields, headers, signature validation, retries, branch filters, pull requests, and replay safety.

## Legal

- [Privacy policy](https://www.fasthook.io/privacy): Privacy Policy for FastHook services and the fasthook.io stats Chrome extension, including data collection, usage, sharing, retention, and security.