Getting Started

This guide walks you through creating your first webhook endpoint, sending a test request, and inspecting the result. The whole process takes under 3 minutes.

1. Sign up

Go to hookcap.dev/register and create a free account. You get 5 permanent endpoints and 3,000 requests per month — no credit card required.

2. Create an endpoint

From the dashboard, click New Endpoint. Give it a name that describes what you are testing (e.g., “stripe-checkout” or “github-push”).

HookCap generates a permanent URL for your endpoint:

https://hookcap.dev/w/your-endpoint-id

This URL does not expire. You can configure your webhook source once and it will keep working until you delete the endpoint.

3. Send a test request

Point any webhook source at your endpoint URL. For a quick test, use curl:

curl -X POST https://hookcap.dev/w/your-endpoint-id \
  -H "Content-Type: application/json" \
  -d '{"event": "test", "data": {"message": "Hello HookCap!"}}'

You can also paste the URL into a webhook provider’s settings (Stripe, GitHub, Shopify, etc.) and trigger a test event from their dashboard.

4. Inspect in real-time

Switch to your HookCap dashboard. The request appears instantly — no refresh needed. HookCap streams incoming requests to your browser via WebSocket.

Click on the request to see the full details:

  • Method — GET, POST, PUT, etc.
  • Headers — all request headers, including content type, signatures, and custom headers
  • Body — the raw payload, formatted as JSON if applicable
  • Query parameters — any URL query strings
  • Metadata — source IP, request size, and timestamp

5. Replay a request

Click the Replay button on any captured request. Enter a target URL — typically your local development server:

http://localhost:3000/webhooks/stripe

HookCap re-sends the exact request (same method, headers, and body) to your target. The replay response (status code, headers, body, duration) is displayed so you can verify your handler processed it correctly.

This is especially useful when iterating on handler code. Fix a bug, replay the same payload, and confirm the fix without re-triggering the original event.

Next steps

Now that you have your first endpoint working, explore these features:

  • Response mocking — Configure what your endpoint returns to the webhook sender. Set custom status codes, headers, and response bodies to test how providers handle errors or specific responses.
  • Multiple endpoints — Create separate endpoints for different integrations or environments. The free plan includes 5 endpoints.
  • Upgrade for more — Need more endpoints, higher request limits, or longer retention? Check out the Pro, Team, and Business plans.