Documentation

Webhook testing without friction

Receive webhooks on localhost instantly with a stable HTTPS URL and detailed request visibility.

Why teams use InstaTunnel for webhooks

Consistent URLs, clear debugging, and secure forwarding.

Stable webhook URL

Use a fixed subdomain so provider dashboards do not break across restarts.

Real-time visibility

Inspect request outcomes and iterate quickly while testing events.

Secure by default

HTTPS endpoints with optional auth controls for safer local development.

Quick setup

Get a public webhook URL in under a minute.

Step 1

Install CLI

npm install -g instatunnel

Step 2

Run tunnel

instatunnel 3000 --subdomain webhook-dev

Step 3

Paste in provider dashboard

Use the generated HTTPS URL in Stripe, GitHub, Shopify, Twilio, or PayPal settings.

Need provider-specific setup?

Open detailed guides with signature verification, retries, and quick fixes.

Provider examples for localhost webhook testing

Use stable provider-specific paths so your handlers, logs, and tests stay predictable.

Stripe

instatunnel 4242 --subdomain stripe-webhooks

Set the endpoint to https://stripe-webhooks.instatunnel.my/webhooks/stripe.

GitHub

instatunnel 3000 --subdomain github-hooks

Set Payload URL to https://github-hooks.instatunnel.my/webhooks/github.

PayPal

instatunnel 3000 --subdomain paypal-dev

Set webhook URL to https://paypal-dev.instatunnel.my/webhooks/paypal.

Decision table

Workflow needInstaTunnelCommon alternative
Provider configurationStable subdomains reduce repeated dashboard edits.Random public URLs make every restart a provider-config change.
Signature verificationProvider docs are linked from each guide with verification reminders.Teams often skip verification during quick local tests.
Retry debuggingUse consistent endpoint paths and event IDs to reproduce failures.Manual replay without idempotency can create duplicate side effects.

Common questions

How do I test webhooks on localhost?

Run your local app, start an InstaTunnel tunnel on that port, and paste the generated HTTPS URL into the provider webhook settings.

Which providers can I test?

The same localhost tunnel pattern works for Stripe, GitHub, Shopify, Twilio, PayPal, OAuth callbacks, and custom webhook senders.

What should I verify before processing events?

Verify the provider signature header, store the event ID for idempotency, and return a fast success response before slow background work.