Webhook Testing

Hookstream gives you a free, no-signup webhook testing tool at hookstream.io/test. Open the page, get a unique URL, and inspect every request in real-time. When you're ready, graduate the session to a full account without losing any data.

No account required. No credit card. No install. Open the page and you have a working webhook URL in under a second.

Create a test session

bash
curl -X POST https://hookstream.io/v1/ingest/src_abc \
  -H "Content-Type: application/json" \
  -d '{"hello":"world"}'

Prefer the terminal? Use the CLI.

hookstream test

hookstream listen

test creates a session and opens the inspector URL. listen creates a session and streams events into your terminal in real-time over WebSocket — headers, body, status, the lot.

Customize the response

By default the ingest URL returns 200 OK. You can override that per session to simulate odd behavior (5xx, redirects, custom bodies):

bash
curl -X PATCH https://hookstream.io/v1/test/sessions/sess_abc/response \
  -H "Content-Type: application/json" \
  -d '{
    "status_code": 201,
    "headers": { "X-Custom": "value" },
    "body": "{\"ok\": true}"
  }'

Forward to localhost (or anywhere)

Tunnel your live test session to your dev server without setting up ngrok:

bash
curl -X PATCH https://hookstream.io/v1/test/sessions/sess_abc/forwarding \
  -H "Content-Type: application/json" \
  -d '{
    "url": "https://your-ngrok-url.ngrok.io/webhook",
    "enabled": true
  }'

Everything else you can do

• Search and filter across received events.
• Copy as code — hookstream generates ready-to-paste snippets in cURL, JavaScript, Python, and Go for any captured request.
• Add notes to events (PUT /v1/test/sessions/:id/events/:eid/note) — handy for documenting what each test was for.
• Export as NDJSON or CSV: GET /v1/test/sessions/:id/export?format=ndjson.
• Configure a custom response body to simulate provider-side quirks.

Graduate to your account

Sign up and hookstream offers to "graduate" your test session: the ingest URL stays exactly the same, but the source and all its events move into your org with full pipeline support — destinations, retries, alerts, collections, everything.

bash
curl -X POST https://hookstream.io/v1/test/sessions/sess_abc/claim \
  -H "X-API-Key: $HOOKSTREAM_API_KEY"

You don't need to update anything on the provider side — the URL keeps working.

Next Steps