Webhook development, from install to replay.

Quickstart

Install the Tofu CLI, create a stable provider URL, and forward Stripe, GitHub, or Resend webhooks to your local app in one terminal session.

How it works

Tofu sits between webhook providers and your local app: stable URL in, persisted event store, configurable targets out. Architecture overview for developers.

Payload retention

Tofu stores request bodies and headers for the replay window, then expires them while keeping event metadata. Manual expiry available for sensitive payloads.

Overview

Reference for every Tofu CLI command: login, hooks, targets, watch, replay, and events expire. Examples for the most common workflows.

tofu hooks

Create stable webhook URLs per provider, print the URL to paste into Stripe or GitHub, list active hooks, and remove hooks you no longer need.

tofu targets

Set a localhost target for your hook, add multiple targets for staging or preview environments, and remove targets when a branch closes.

tofu watch

Stream incoming webhook events and delivery results in the terminal. Filter by hook, see signature headers, response bodies, and target latency.

tofu replay

Replay the latest event or a specific event ID to your local target after fixing a handler. Works while the payload is still inside the retention window.

Stripe

Create a stable Stripe webhook URL, forward events to your local Stripe handler, and replay events without breaking signature verification.

GitHub

Point a GitHub repository webhook at Tofu, forward push and pull request events to localhost, and replay payloads while fixing your handler.

Resend

Keep a stable Resend webhook endpoint while your local notification handler moves. Replay delivery, bounce, and complaint events on demand.

Clerk

Forward Clerk user, organisation, and session events to your local handler. Replay account-sync payloads after changing webhook validation logic.

Supabase

Forward Supabase auth, database, and edge function events to localhost. Replay real payloads against your local Next.js or Node handler.

CI targets

Add an ephemeral webhook target inside a CI job or preview deploy, replay a real provider event, and remove the target before the job exits.

AI diagnosis

Use Tofu's delivery diagnosis to explain failed webhook forwards, inspect evidence, and get suggested fixes without sending full raw payloads to AI.

Troubleshooting

Checklist for when events are not reaching your local app: provider URL drift, incomplete target paths, signature handlers, and replay windows.

Diagnosis API

Authenticated API endpoints for retrieving and generating webhook delivery diagnoses from the dashboard, CLI, or your own tools.