Skip to main content

Quick Start

Get your first webhook endpoint running in under 5 minutes.

1. Create an account​

Sign up at hooklistener.com using GitHub, Google, or email. You'll land in the Webhook Inspector dashboard.

2. Create a debug endpoint​

Click New Endpoint in the dashboard. Give it a name like "My First Endpoint" and optionally set a custom slug. Hooklistener generates a unique URL for you:

https://app.hooklistener.com/w/my-first-endpoint

Any HTTP request sent to this URL is captured and displayed in real time.

3. Send a test request​

Use curl or any HTTP client to send a request to your endpoint:

curl -X POST https://app.hooklistener.com/w/my-first-endpoint \
  -H "Content-Type: application/json" \
  -d '{"event": "test", "data": {"message": "Hello, Hooklistener!"}}'

The request appears instantly in your dashboard with full headers, body, and metadata.

4. Forward to localhost​

Install the CLI to forward captured webhooks to your local development server:

# Install via Homebrew
brew tap hooklistener/tap
brew install hooklistener

# Authenticate
hooklistener login

# Forward webhooks to localhost:3000
hooklistener listen my-first-endpoint --target http://localhost:3000

Every webhook that hits your endpoint is now forwarded to your local server in real time, with a full interactive TUI for inspecting requests.

5. Or use a tunnel​

Skip the endpoint entirely and expose your local server with a public URL:

hooklistener tunnel --port 3000

You'll get a URL like https://abc123.hooklistener.dev that tunnels directly to your local machine.

What's next?​