Webhooks

Test webhooks locally with a secure tunnel

Point Stripe, GitHub, Shopify, Slack or any other provider at your tunnel, watch each delivery arrive at your local app, check its signature and replay it after you fix your code.

Inspector and replay on all plans. Signature checks and the offline inbox need Starter or higher.

Terminal
npx @instawormhole/connector 3000

Shares your local webhook handler on port 3000.

One URL per provider

Give the provider your tunnel's address plus the path your app handles, such as /webhooks/stripe.

See and verify each delivery

The inspector shows every delivery and, with the signing secret added, whether its signature is valid.

Replay instead of re-triggering

Fixed a bug? Replay the same delivery from the inspector without creating a new event at the source.

Set it up in a few minutes

Use a durable tunnel so the address stays the same and deliveries are recorded.

  • Create a durable tunnel in the dashboard and connect it with the command it shows.
  • Enter https://your-tunnel.instawormhole.site/your/path as the webhook endpoint in the provider's dashboard.
  • Send a test event and open it in the inspector to see the status your app returned.
  • Add the provider's signing secret to the tunnel to check signatures.

Do not lose webhooks while you are offline

Turn on the webhook inbox for up to 10 paths, and POST, PUT and PATCH requests are held while your connector is stopped. The sender gets a 202 reply. When you reconnect, held requests are delivered to your app in order, about two a second. Up to 100 requests of up to 64 KiB are held, for 24 hours on Starter and Pro or 72 hours on Team and Business.

The inbox needs a tunnel without a password or token, because a webhook sender cannot send either.

Tunnel or the provider's CLI?

Stripe's own listen command forwards Stripe events to a local address and works well for Stripe alone. A tunnel helps when you test several providers, or endpoints you configure in a provider's dashboard.

Questions

Can I protect a webhook tunnel with a password?
A provider cannot type a password, so keep webhook tunnels open or limit them by IP list. The inbox needs a tunnel without a password or token.
Does the signature check block invalid requests?
No. It tells you whether a captured request carries a valid signature; your app should verify signatures itself.

Share your local app in a minute

Free plan: 3 tunnels online at once and 5 GB a month. No card needed.