# CatchHook

> Webhook debugging platform for developers. Catch, inspect, replay, forward, and tunnel webhooks in real time. Used by developers and teams to debug webhook integrations with Stripe, GitHub, Shopify, Twilio, and any HTTP callback sender.

## Overview

- [Product Overview](https://catchhook.app/product): Full feature tour — real-time inspection, replay, forwarding, localhost tunneling, and AI debugging
- [Pricing & Plans](https://catchhook.app/plans): Pro ($10/mo, 10 endpoints) and Business ($49/mo, unlimited endpoints, teams, custom domains)
- [Live Demo](https://try.catchhook.app): Try instantly without signing up — temporary endpoint with 48-hour retention

## Documentation

- [Getting Started](https://docs.catchhook.app/getting-started): Create your first endpoint and receive a webhook in under 2 minutes
- [Endpoints](https://docs.catchhook.app/endpoints): Create, configure, and manage webhook endpoints with custom IDs, subdomains, and response codes
- [Webhook Requests](https://docs.catchhook.app/webhook-requests): View, search, export, replay, and download incoming webhooks
- [Forwarding](https://docs.catchhook.app/forwarding): Auto-forward webhooks with conditional routing rules, retries, and circuit breaker protection
- [Tunneling & CLI](https://docs.catchhook.app/tunneling): Stream webhooks to your local machine for development via WebSocket
- [Alerts](https://docs.catchhook.app/alerts): Set up alerts for missing webhooks, errors, and traffic anomalies
- [Notification Channels](https://docs.catchhook.app/notification-channels): Route alert notifications to Slack, PagerDuty, Discord, Teams, email, or webhooks
- [Custom Domains](https://docs.catchhook.app/custom-domains): Receive webhooks on your own domain (Business plan)
- [Outbound Webhooks](https://docs.catchhook.app/outbound-webhooks): Get notified when CatchHook events occur (Business plan)
- [Teams](https://docs.catchhook.app/teams): Collaborate with your team on shared endpoints (Business plan)
- [API Reference](https://docs.catchhook.app/api): Full REST API for endpoints, requests, forwarding, and events
- [Billing & Plans](https://docs.catchhook.app/billing): Plan comparison, trials, and subscription management
- [Account Settings](https://docs.catchhook.app/account-settings): Branding, API tokens, Slack integration, and team members
- [Security & Privacy](https://docs.catchhook.app/security): Encryption, rate limits, and data handling
- [Full Documentation (single file)](https://catchhook.app/llms-full.txt): All documentation concatenated for LLM context windows

## API

- Base URL: `https://catchhook.app/api/v1`
- Authentication: Bearer token in `Authorization` header
- Token scopes: `read` (list/view resources), `write` (create/update/delete), `tunnel` (WebSocket connections)
- [OpenAPI Spec](https://catchhook.app/openapi.json): Machine-readable OpenAPI 3.1 specification
- [API Reference](https://docs.catchhook.app/api): Human-readable API documentation

### Key API Endpoints

- `GET /api/v1/endpoints` — List all endpoints
- `POST /api/v1/endpoints` — Create an endpoint (params: name, provider)
- `GET /api/v1/endpoints/:id/requests` — List webhook requests for an endpoint
- `POST /api/v1/endpoints/:endpoint_id/requests/:id/replay` — Replay a webhook to a target URL
- `POST /api/v1/endpoints/:endpoint_id/forwarding_targets` — Create auto-forwarding target
- `GET /api/v1/events` — List recent account activity events
- `POST /api/v1/tunnel/connect` — Get WebSocket ticket for localhost tunneling

## CLI

- Package: `@catchhook/tunnel` on npm
- Install: `npm install -g @catchhook/tunnel` or use `npx @catchhook/tunnel`
- Start tunnel: `npx @catchhook/tunnel start --endpoint ep_xxx --port 3000`
- With provider: `npx @catchhook/tunnel start --provider stripe --port 3000`
- Anonymous: `npx @catchhook/tunnel start ep_xxx --key tkey_xxx --port 3000`
- Auth: `npx @catchhook/tunnel auth login` (opens browser for token)

## Webhook Providers

CatchHook automatically detects and provides enhanced support for:

- **Stripe**: Signature verification via `Stripe-Signature`, event type extraction (e.g., `invoice.paid`)
- **GitHub**: Signature verification via `X-Hub-Signature-256`, event type from `X-GitHub-Event` header
- **Shopify**: Signature verification via `X-Shopify-Hmac-SHA256`
- **Twilio**: Signature verification via `X-Twilio-Signature`
- **Generic HMAC**: Configurable header and algorithm

## Comparisons

- [CatchHook vs. Webhook.site](https://catchhook.app/compare/webhook-site)
- [CatchHook vs. RequestBin](https://catchhook.app/compare/requestbin)
- [CatchHook vs. Hookdeck](https://catchhook.app/compare/hookdeck)
- [CatchHook vs. Beeceptor](https://catchhook.app/compare/beeceptor)
- [CatchHook vs. ngrok](https://catchhook.app/compare/ngrok)