Receive a webhook

You will end this page with a public HTTPS endpoint and the full contents of a request that reached it. There is nothing to install, no account, and no local server to start.

1. Open the webhook tester

Open the webhook tester

A guest profile is created in your browser and an endpoint is provisioned for you on the spot. There is no form and no email step. The endpoint appears under Webhook URL and looks like this:

Your endpoint
https://your-endpoint.mercur.sh

Copy the URL from the page — the subdomain shown there is yours and differs from the placeholder above.

2. Send a request to it

Any method and any path is accepted. Replace the host with your own and run:

Run
curl -i -X POST https://your-endpoint.mercur.sh/orders/created \
-H "content-type: application/json" \
-d '{"id":"evt_1","amount":1200}'

The response is 204 No Content, every time. That is the point of this mode: the relay accepts and records the request without forwarding it anywhere, so you can point a provider at the URL before you have written a single line of handler code.

3. Read what arrived

Look at Request logs on the same page. New requests appear on their own every few seconds, and there is a Refresh button if you would rather not wait. Select the entry to see what the sender actually transmitted:

  • method, path and query string
  • request headers
  • the request body
  • timing, the caller's IP address and user agent

The response side stays empty here, because nothing was forwarded and so there was no response to record.

4. Point a real provider at it

The endpoint behaves like any other webhook URL, so you can paste it into a provider's dashboard — a Stripe endpoint, a GitHub webhook, or your own service — and inspect the first delivery attempt. Signature headers, unusual content types and retries all arrive as sent, because nothing is rewritten on the way in.

What guest mode includes

  • 1,000 requests per month
  • 50 stored requests on the endpoint, after which the oldest are dropped
  • 2 concurrent sessions
  • Stored requests are deleted after 30 days

Guest mode does not forward traffic to your machine. The endpoint only records.

Keep the endpoint

Create an account and the same endpoint moves across with its history, so the URL you already gave a provider keeps working. The free plan then adds an endpoint of your own that can forward to a local port.

Next: expose a local service.