Complete webhook create and test flow
This guide walks through creating and testing a webhook end to end. Read webhooks and webhook security first.
For delivery failures after launch, see webhook delivery failures.
Part 1 — Plan and create
- Confirm you are in the correct business workspace.
[Screenshot: App header — correct business workspace selected.]
- Document which events your automation needs (approved sale, subscription, etc.).
[Screenshot: Event plan — required webhook events listed.]
- Open Integrations → Webhooks → create webhook.
[Screenshot: Create webhook — new webhook form opened.]
- Enter HTTPS endpoint URL (publicly reachable).
[Screenshot: Endpoint URL — valid HTTPS URL entered.]
- Select events — prefer approved sale events over PIX generated alone.
[Screenshot: Event checkboxes — approved purchase events selected.]
- Save webhook and note signing secret if shown. See webhook security.
[Screenshot: Webhook secret — signing key copied securely.]
Part 2 — Simulator test
- Open webhook simulator for one selected event type.
[Screenshot: Simulator — test event type chosen.]
- Send simulated payload to endpoint.
[Screenshot: Simulator send — test delivery triggered.]
- Open delivery logs — confirm 2xx success response.
[Screenshot: Logs — simulator delivery success with 200 status.]
- Verify external system (Zapier, Make, custom API) received payload.
[Screenshot: External system — test event received and parsed.]
- If failed, fix endpoint before production. See Zapier/Make.
[Screenshot: Endpoint fix — error response resolved to 200.]
Part 3 — Production verification
- Run safe test purchase on staging or low-value offer.
[Screenshot: Test checkout — purchase completed for webhook test.]
- Confirm sale approved in Sales.
[Screenshot: Sales — approved test sale for webhook trigger.]
- Check webhook logs for production delivery attempt.
[Screenshot: Production log — real event delivered successfully.]
- Confirm external automation runs once (no duplicate processing).
[Screenshot: External automation — single execution for one sale.]
- Enable monitoring alert for failed deliveries if available.
[Screenshot: Monitoring — alert or log review scheduled.]
Event selection cheat sheet
| Event | Safe for delivery? |
|---|---|
| Sale approved | Yes |
| PIX generated only | No — not paid |
| Cart abandoned | Recovery only |
| Subscription canceled | Access workflows |