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:
- Method —
POST - 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
| Problem | Fix |
|---|---|
404 from HookDeploy | Check the slug in your URL — copy it fresh from the dashboard |
423 Locked | Endpoint is paused — unpause it in endpoint settings |
413 Payload Too Large | Body exceeds your plan’s max payload size — see Plans |
429 Too Many Requests | Monthly request limit reached — upgrade or wait for the next billing period |
| Request not appearing | Refresh the endpoint page — realtime can take 1–2 seconds on first load |
Next steps
- Your first endpoint — Learn the inspector in detail
- Forwarding — Auto-proxy webhooks to your server
- API overview — Manage endpoints programmatically