Endpoints
Creating webhook URLs and configuring mock responses
What's an endpoint?
An endpoint is a permanent URL that captures incoming HTTP requests. Each endpoint has a unique slug, so your webhook URL looks like:
https://thunderhooks.com/h/{slug}
All HTTP methods work — POST, GET, PUT, PATCH, DELETE, and anything else your provider sends.
Creating endpoints
From the dashboard, click New Endpoint and enter a name. ThunderHooks generates a random slug, but you can customize it if you want something memorable.
Mock responses
By default, endpoints return a 200 OK with an empty body. You can customize this to simulate your real API:
- Open the endpoint and click Settings
- Enable Mock Response
- Set the status code (e.g.
201) - Add a response body
{
"status": "received",
"id": "mock-12345"
}
This is useful when the webhook provider expects a specific response format or status code to confirm delivery.
Request history
Every request is stored and available in the endpoint detail view. You can see:
- The 50 most recent requests
- Full headers, body, and query params for each
- Timestamp and source IP
Replaying requests
Click Replay on any captured request to re-send it to an arbitrary URL. This is handy for:
- Debugging a handler that failed on the original delivery
- Testing retries against your local development server
- Reproducing issues in a staging environment
Real-time updates
The endpoint detail page uses server-sent events (SSE) to show new requests as they arrive. No need to refresh — incoming webhooks appear instantly.