Skip to content
newThe webhook.co MCP server is live — turn any webhook into an agent event. Read the docs
test locally

Test webhooks locally

A webhook you can't see is a webhook you can't debug. Capture the real request, stream it to a port on your machine, and replay it as often as you need — no tunnel to babysit, no redeploy between attempts.

Not listed? The loop is the same for every provider — point it at your ingest URL and the request is captured whole. You can also send one to a throwaway URL without an account, or check a captured signature by hand in the signature verifier.

How testing a webhook locally works

A provider delivers a webhook from its own servers, over the public internet — so it can't reach localhost, and most providers have no "send test" button to prove otherwise. Testing one locally means giving it a public URL it will actually call, and getting whatever lands there down onto the machine where your handler runs.

The loop is the same for every provider above. Create an endpoint and it prints a permanent ingest URL; point the provider at it and every request is captured whole — headers, body, the exact bytes. Stream those captures to a port on your machine, and replay any one of them as often as you need while you fix the handler, without re-triggering anything upstream.

Webhook testing: common questions

Can a provider send a webhook to localhost?

No. Deliveries come from the provider's own servers over the public internet, so localhost and 127.0.0.1 aren't reachable from where the request originates. Point the provider at a permanent public URL that forwards down to your machine instead.

How do I test a webhook without deploying?

Capture the real request at a permanent URL and stream it to the handler running on your laptop. You see production-shaped traffic without shipping anything, and you can keep iterating on the handler against the same captured event.

How do I replay a webhook?

Every captured request can be replayed on demand, as many times as you need. You debug against the exact event that failed instead of re-triggering it upstream and hoping the next one looks the same.

Why doesn't my webhook show up on my machine?

Usually the provider can't reach the URL you gave it. The endpoint has to be a public HTTPS URL, and many providers accept only certain ports and won't follow a redirect. Confirm the request is arriving at the ingest URL first, then look at the handler.