HookDeploy

This guide walks you from account creation to a captured webhook with a real payload — no local server required.

1. Create an account

Go to app.hookdeploy.dev/signup and create an account. On signup, HookDeploy automatically creates:

  • Your user profile
  • A personal organization (named after you)
  • A free-plan subscription

You’ll land on the dashboard with zero endpoints.

2. Create an endpoint

Click New endpoint (or go to Endpoints → Create). Give it a name like Quickstart test. HookDeploy generates a slug automatically.

Your webhook URL looks like:

https://hookdeploy.dev/h/k3p9xa

Copy it — you’ll need it in the next step.

3. Send a test webhook

Open a terminal and send a POST request to your endpoint URL. Replace k3p9xa with your actual slug:

curl -X POST "https://hookdeploy.dev/h/k3p9xa" \
  -H "Content-Type: application/json" \
  -d '{"event":"payment.succeeded","amount":4200,"currency":"usd"}'

HookDeploy responds immediately:

{"request_id":"550e8400-e29b-41d4-a716-446655440000"}

The sender gets 200 even if your local dev server isn’t running. That’s the point — HookDeploy captures first, you inspect later.

4. View the request in the dashboard

Go back to the dashboard and open your endpoint. The request appears in the live stream within a second or two.

Click the request to open the inspector. You’ll see:

  • MethodPOST
  • Headers — including content-type: application/json
  • Body — the JSON payload you sent
  • Source IP — the IP curl resolved from
  • Timestamp — when the request arrived

5. (Optional) Point a real provider at HookDeploy

To test with a real webhook sender, paste your HookDeploy URL into the provider’s webhook settings. Examples:

Stripe — Dashboard → Developers → Webhooks → Add endpoint

GitHub — Repository → Settings → Webhooks → Add webhook

Shopify — Settings → Notifications → Webhooks → Create webhook

Select the events you care about, save, and trigger an event. It shows up in HookDeploy the same way your curl test did.

6. (Optional) Replay to localhost

If you have a local server listening for webhooks (via ngrok or similar), select a captured request and click Replay. Enter your target URL:

https://your-ngrok-id.ngrok.io/webhooks/stripe

HookDeploy re-sends the original method, headers, and body. Your local handler runs with the exact payload that hit HookDeploy.

Troubleshooting

ProblemFix
404 from HookDeployCheck the slug in your URL — copy it fresh from the dashboard
423 LockedEndpoint is paused — unpause it in endpoint settings
413 Payload Too LargeBody exceeds your plan’s max payload size — see Plans
429 Too Many RequestsMonthly request limit reached — upgrade or wait for the next billing period
Request not appearingRefresh the endpoint page — realtime can take 1–2 seconds on first load

Next steps