Getting Started with HookReplay

Learn how to capture, inspect, and replay webhooks to your localhost in under 5 minutes.

What is HookReplay?

HookReplay is a webhook debugging tool that captures incoming webhooks from services like Stripe, GitHub, Shopify, and more, then lets you inspect them and replay them to your local development server.

Capture

Receive webhooks from any service with a unique URL that captures every request.

Inspect

View headers, body, query parameters, and metadata for every captured request.

Replay

Send captured webhooks to your localhost with one click using our CLI tool.

Quick Start

Create an account

Sign up for a free HookReplay account. No credit card required.

Create Account

Create a workspace and endpoint

After signing in, create a workspace for your project, then create a webhook endpoint. You'll get a unique URL like:

https://hookreplay.dev/hook/abc123xyz

Configure your webhook provider

Use your HookReplay URL as the webhook destination in your service (Stripe, GitHub, Shopify, etc.).

Tip

Many services have a "test" or "send test webhook" button. Use it to verify your setup!

Install the CLI

Install the HookReplay CLI to replay webhooks to your localhost:

npm
npm install -g hookreplay

Or run directly with npx:

npx
npx hookreplay

Connect and replay

Get an API key from your account settings, then configure and connect:

Interactive CLI
# Start the CLI
hookreplay

# Configure your API key (only needed once)
config api-key hr_xxxxxxxxxxxx

# Connect to the server
connect

Now click "Replay" on any captured request in the web dashboard. When you specify your localhost URL (e.g., http://localhost:3000/webhook), the webhook will be sent to your local server!

Example: Testing Stripe Webhooks

Here's a complete example of using HookReplay to test Stripe payment webhooks:

1. Stripe Dashboard
# In Stripe Dashboard → Developers → Webhooks
# Add endpoint: https://hookreplay.dev/hook/your-token
# Select events: payment_intent.succeeded, checkout.session.completed
2. Start CLI and connect
$ hookreplay

● hookreplay> config api-key hr_xxxx
✓ API key saved!

● hookreplay> connect
✓ Connected! Waiting for replay requests...
3. Test and replay
# Make a test payment in Stripe
# View the webhook in HookReplay dashboard
# Click "Replay" and enter your localhost URL:
#   http://localhost:3000/api/stripe/webhook
# The CLI will forward it to your local server!

Next Steps