# HookBridge Docs

> HookBridge is a webhook delivery service that handles signing, queuing, retries, rate limiting, and observability so developers don't have to build webhook infrastructure themselves. These docs cover Outbound (sending webhooks to your customers), Inbound (receiving webhooks from third-party providers), and Pull (polling for queued events), plus the CLI and SDKs for Node, Python, Go, Ruby, and PHP.

The HMAC-SHA256 signing scheme, two-tier exponential-backoff retry behavior, dead-letter queues, idempotency model, and rate-limiting semantics are all documented in the per-mode guides below. The full HTTP API is documented under API Reference, generated from the OpenAPI spec.

## Getting Started

- [Introduction](https://docs.hookbridge.io/getting-started/introduction/): What HookBridge is, who it's for, and how the three delivery modes fit together
- [Send Webhooks Quickstart](https://docs.hookbridge.io/getting-started/send-webhooks/): Create an outbound endpoint and deliver your first signed webhook
- [Receive Webhooks Quickstart](https://docs.hookbridge.io/getting-started/receive-webhooks/): Create an inbound endpoint and forward verified webhooks to your service
- [Local Development](https://docs.hookbridge.io/getting-started/local-development/): Use the CLI to tunnel webhooks to localhost

## Outbound (Sending Webhooks)

- [Outbound Overview](https://docs.hookbridge.io/guides/outbound/overview/): Concepts, endpoint model, and delivery flow
- [Send Webhooks](https://docs.hookbridge.io/guides/outbound/send-webhooks/): API surface and SDK calls for publishing events
- [Signature Verification](https://docs.hookbridge.io/guides/outbound/signature-verification/): HMAC-SHA256 scheme that your customers' receivers must implement
- [Retry Behavior](https://docs.hookbridge.io/guides/outbound/retry-behavior/): Two-tier exponential backoff with jitter
- [Idempotency](https://docs.hookbridge.io/guides/outbound/idempotency/): Idempotency keys and dedup semantics
- [Rate Limiting](https://docs.hookbridge.io/guides/outbound/rate-limiting/): Per-endpoint rate limits and 429 handling
- [Dead Letter Queue](https://docs.hookbridge.io/guides/outbound/dlq/): Where exhausted retries go and how to replay them

## Inbound (Receiving Webhooks)

- [Inbound Overview](https://docs.hookbridge.io/guides/inbound/overview/): Concepts and forwarding model
- [Verification Options](https://docs.hookbridge.io/guides/inbound/verification-options/): HMAC, static token, and IP allowlist verification for incoming webhooks
- [Idempotency](https://docs.hookbridge.io/guides/inbound/idempotency/): Dedup of inbound messages
- [Retry Behavior](https://docs.hookbridge.io/guides/inbound/retry-behavior/): Retries against your destination URL
- [Message Operations](https://docs.hookbridge.io/guides/inbound/message-operations/): Inspecting and replaying received messages

## Pull (Polling for Events)

- [Pull Overview](https://docs.hookbridge.io/guides/pull/overview/): When to use pull instead of push
- [Retrieving Events](https://docs.hookbridge.io/guides/pull/retrieving-events/): Cursor-based event retrieval
- [Event Type Extraction](https://docs.hookbridge.io/guides/pull/event-type-extraction/): Mapping provider payloads to event types

## CLI

- [Installation](https://docs.hookbridge.io/guides/cli/installation/): Install the HookBridge CLI
- [Command Reference](https://docs.hookbridge.io/guides/cli/commands/): All CLI subcommands and flags
- [How It Works](https://docs.hookbridge.io/guides/cli/how-it-works/): Tunnel architecture and auth model

## SDKs

- [Node.js SDK](https://docs.hookbridge.io/sdks/node/): Installation, client usage, and signature verification helpers
- [Python SDK](https://docs.hookbridge.io/sdks/python/): Installation, client usage, and signature verification helpers
- [Go SDK](https://docs.hookbridge.io/sdks/go/): Installation, client usage, and signature verification helpers
- [Ruby SDK](https://docs.hookbridge.io/sdks/ruby/): Installation, client usage, and signature verification helpers
- [PHP SDK](https://docs.hookbridge.io/sdks/php/): Installation, client usage, and signature verification helpers

## API Reference

- [API Reference](https://docs.hookbridge.io/api/): Full HTTP API generated from the OpenAPI spec
- [OpenAPI Specification (YAML)](https://docs.hookbridge.io/openapi.yaml): Raw OpenAPI 3 spec for code generation, tool use, and SDK scaffolding

## Optional

- [Endpoint Lifecycle (Outbound)](https://docs.hookbridge.io/guides/outbound/endpoint-lifecycle/): Creating, updating, disabling endpoints
- [Endpoint Lifecycle (Inbound)](https://docs.hookbridge.io/guides/inbound/endpoint-lifecycle/): Creating, updating, disabling inbound endpoints
- [Endpoint Lifecycle (Pull)](https://docs.hookbridge.io/guides/pull/endpoint-lifecycle/): Pull endpoint management
- [Pull Verification Options](https://docs.hookbridge.io/guides/pull/verification-options/): Verification when ingesting pulled events
- [Pull Idempotency](https://docs.hookbridge.io/guides/pull/idempotency/): Dedup for pulled events
- [Pull Monitoring](https://docs.hookbridge.io/guides/pull/monitoring/): Operational signals for pull endpoints
- [Inbound Rejections](https://docs.hookbridge.io/guides/inbound/rejections/): Why messages get rejected and how to inspect them
- [Inbound Monitoring and Recovery](https://docs.hookbridge.io/guides/inbound/monitoring-recovery/): Alerting and replay for inbound
- [Outbound Monitoring and Recovery](https://docs.hookbridge.io/guides/outbound/monitoring-recovery/): Alerting and replay for outbound
- [Outbound Exports](https://docs.hookbridge.io/guides/outbound/exports/): Bulk export of delivery data
- [Inbound Exports](https://docs.hookbridge.io/guides/inbound/exports/): Bulk export of received messages
- [Dashboard](https://docs.hookbridge.io/guides/observability/dashboard/): Console dashboard overview
- [Analytics](https://docs.hookbridge.io/guides/observability/analytics/): Delivery analytics
- [Logs and Metrics Mapping](https://docs.hookbridge.io/guides/observability/logs-metrics-mapping/): How console fields map to logged and emitted metrics
- [Exports Operations](https://docs.hookbridge.io/guides/observability/exports/): Managing exports
- [Projects](https://docs.hookbridge.io/guides/product/projects/): Project model and isolation
- [API Keys](https://docs.hookbridge.io/guides/product/api-keys/): Creating and rotating API keys
- [Settings](https://docs.hookbridge.io/guides/product/settings/): Project and account settings
- [Alerts](https://docs.hookbridge.io/guides/product/alerts/): Slack and email alerting
- [Error Handling](https://docs.hookbridge.io/guides/product/error-handling/): Error model and HTTP status semantics
- [URL Requirements](https://docs.hookbridge.io/guides/product/url-requirements/): Allowed destination URL formats
- [Payload Retention](https://docs.hookbridge.io/guides/product/payload-retention/): How long payloads are stored
- [Deleting Messages](https://docs.hookbridge.io/guides/product/message-deletion/): Message deletion semantics
- [Billing](https://docs.hookbridge.io/guides/product/billing/): Plans and usage metering