Skip to content
@hooktracehq

Hooktrace

Modern webhook infrastructure for developers. Debug, retry, and route webhooks with confidence.

HookTrace

Open-source webhook infrastructure for developers.
Receive, inspect, deliver, retry, and replay webhooks with a self-hostable stack built for visibility and control.

License: Apache 2.0 Self-hosted Status: v0.1.0


Why HookTrace?

Webhooks fail, and they usually fail silently. HookTrace shows you what happened to every event.

When... HookTrace lets you...
Webhooks fail silently See whether an event arrived, what payload was received, and what happened during delivery.
Downstream services go down Retry failed deliveries instead of losing events.
You need to debug production events Inspect payloads, headers, providers, and delivery attempts.
You need to reproduce an event Replay it without triggering the provider again.

How it works

Webhook Provider
       ↓
   HookTrace
       ↓
Receive → Inspect → Store → Deliver
                         ↓
                   Retry / Replay
                         ↓
                 Your Application

Features

  • Receive webhooks from any provider
  • Inspect payloads, headers, and providers
  • Store every event
  • Deliver to your configured targets
  • Retry failed deliveries
  • Replay past events on demand
  • Local webhook tunnels for development
  • Provider integrations (see below)
  • Metrics and observability
  • Self-hosting with Docker Compose

Quick start

git clone https://github.com/hooktracehq/hooktrace.git
cd hooktrace
cp .env.example .env
docker compose up -d

Once the stack is running:

Service URL
Dashboard http://localhost:3000
API http://localhost:3001
API Docs http://localhost:3001/docs

Local development with tunnels

HookTrace tunnels let you receive real webhook requests locally without exposing your application directly to the public internet.

Integrations

Provider concepts currently covered:

  • Stripe
  • GitHub
  • Razorpay
  • Shopify
  • Slack
  • Discord
  • Notion
  • Supabase
  • Generic webhooks

Note: check each provider against the current code before release and mark anything that is not yet production-ready.

Architecture

                    ┌───────────────┐
                    │ Webhook       │
                    │ Providers     │
                    └───────┬───────┘
                            │
                            ▼
                    ┌───────────────┐
                    │   HookTrace   │
                    │      API      │
                    └───────┬───────┘
                            │
                 ┌──────────┼──────────┐
                 ▼          ▼          ▼
            PostgreSQL    Redis      Workers
                                      │
                                      ▼
                              Delivery Targets

Configuration

Copy .env.example to .env and adjust the values for your environment.

Contributing

Contributions are welcome. Open an issue to discuss larger changes, then submit a pull request.

  1. Fork the repository
  2. Create a feature branch
  3. Commit your changes
  4. Open a pull request

License

HookTrace is open source and released under the Apache License 2.0. Inspect the code, self-host the stack, modify it for your needs, and contribute.

Links

Pinned Loading

  1. hooktrace hooktrace Public

    Hooktrace — Open-source programmable webhook infrastructure for developers. Build, receive, inspect, aggregate, deliver, retry, replay, and debug webhooks with real-time visibility and AI-powered d…

    TypeScript 5 1

Repositories

Showing 2 of 2 repositories

People

This organization has no public members. You must be a member to see who’s a part of this organization.

Top languages

Loading…

Most used topics

Loading…