> ## Documentation Index
> Fetch the complete documentation index at: https://docs.hookstream.io/llms.txt
> Use this file to discover all available pages before exploring further.

# hookstream

The modern event gateway for developers. Ingest, transform, route, and deliver webhooks with retries, DLQ, real-time streaming, and full observability.

hookstream is an event gateway that sits between your webhook senders and your infrastructure. It ingests events, applies filters and transforms, delivers them to 8 destination types with automatic retries, and gives you end-to-end observability. Built on Cloudflare Workers and Durable Objects, it's fast at the edge and cheap to run.

**[Quickstart](/getting-started/quickstart)**

Send your first webhook in under 5 minutes. Create a source, a destination, connect them, and watch events flow.
  **[How it works](/getting-started/how-it-works)**

The architecture: sources, connections, destinations, and the delivery pipeline with retries and circuit breakers.
  **[API Reference](/api/authentication)**

Every endpoint, parameter, and response. Authenticate with API keys or session cookies.
  **[CLI](/cli/overview)**

Manage everything from the terminal. `hookstream listen` streams events locally for debugging.

## What you can build

**[Receive provider webhooks](/getting-started/first-webhook)**

Stripe, Shopify, GitHub, Twilio — 15+ templates with signature verification preconfigured.
  **[Route to any destination](/concepts/destinations)**

HTTP, AWS (SQS, S3, EventBridge), GCP Pub/Sub, Kafka, RabbitMQ, WebSocket.
  **[Filter and transform](/concepts/filters-transforms)**

Content-based filters with 9 operators. JSONata transforms for reshaping payloads.
  **[Topics and pub/sub](/concepts/topics-pubsub)**

Fan out events to many subscribers, each with their own filters and transforms.
  **[Instant database](/concepts/instant-database)**

Sync events into queryable collections with automatic schema inference.
  **[Test locally](/guides/webhook-testing)**

Ephemeral test sessions with a live inspector — no signup needed.

## Core primitives

**Sources**

A **source** is a webhook endpoint. Each source gets a unique URL like `https://hookstream.io/v1/ingest/<source_id>` that accepts any HTTP method. Optional signature verification, IP filtering, deduplication.
  **Destinations**

A **destination** is where events get delivered. Every destination runs on its own DeliveryScheduler Durable Object with retries, circuit breaker, and DLQ.
  **Connections**

A **connection** links a source to a destination. Add content-based filters and JSONata transforms to shape what gets delivered where.
  **Events**

Every incoming request becomes an **event** — immutable, searchable, replayable. See live delivery attempts in the dashboard or via WebSocket.

## Try it right now

No signup required — [open the test inspector](https://hookstream.io/test), copy the temporary URL, and send it a POST. You'll see the event land live in the two-panel inspector with headers, body, and a custom response configurator.

```bash curl
curl -X POST https://hookstream.io/v1/ingest/<source_id> \
  -H 'Content-Type: application/json' \
  -d '{"type": "order.created", "data": {"id": "ord_123", "amount": 4999}}'
```

```javascript fetch
await fetch('https://hookstream.io/v1/ingest/<source_id>', {
  method: 'POST',
  headers: { 'Content-Type': 'application/json' },
  body: JSON.stringify({
    type: 'order.created',
    data: { id: 'ord_123', amount: 4999 },
  }),
});
```

```python requests
import requests

requests.post(
    'https://hookstream.io/v1/ingest/<source_id>',
    json={'type': 'order.created', 'data': {'id': 'ord_123', 'amount': 4999}},
)
```

```go net/http
body := []byte(`{"type":"order.created","data":{"id":"ord_123","amount":4999}}`)
http.Post("https://hookstream.io/v1/ingest/<source_id>", "application/json", bytes.NewReader(body))
```

You don't need to run a server to receive webhooks. Use [webhook testing](/guides/webhook-testing) to spin up an instant public URL and inspect requests in real time.

## Most-read guides

**[Signature Verification](/guides/signature-verification)**

HMAC-SHA256, SHA1, and Standard Webhooks. Preconfigured for Stripe, GitHub, Shopify, and more.
  **[Retry Strategies](/guides/retry-strategies)**

Exponential, linear, fixed. Configure per-destination backoff and max attempts.
  **[Circuit Breaker](/guides/circuit-breaker)**

How hookstream protects failing endpoints and when it probes recovery.
  **[Monitoring & Alerts](/guides/monitoring-alerts)**

Issue auto-creation, 5 alert rule types, webhook + email notification channels.