Before you start
- A tunnel tool that gives your local server a public HTTPS URL (ngrok, Cloudflare Tunnel, or
similar) — Get2Dial requires
https://and won’t deliver to a private or loopback address.
Steps
1
Start your local server and tunnel
Run your webhook handler locally, then start your tunnel tool pointed at its port. Note
the public HTTPS URL it gives you.
2
Create a subscription pointed at the tunnel URL
See React to call events for the exact
request. Use the tunnel’s URL, and save the signing secret it returns.
3
Trigger a real event
Place or receive a test call — see Testing without a sandbox
— to generate a real delivery.
4
Replay it while you iterate
Once you’ve received one real delivery, you don’t need to place another test call for
every code change. Open Settings > Integrations > Webhooks, find the delivery, and
select Replay to resend the same payload to your endpoint again.
Verify
Your local server receives the delivery, and its signature verifies successfully — see
Verify webhook signatures.
Common problems
- Your tunnel URL changed and deliveries stopped. Most tunnel tools issue a new URL each session unless you’re on a paid plan with a fixed one — update the subscription’s URL when it changes.
- You want to test a payload shape you haven’t triggered yet. Build it from the event
catalog’s published example and
POSTit to your own endpoint directly — that tests your handler, just not the real delivery path.