Webhook Debugging Guide
Diagnostic Steps
Step 1: Verify Webhook Configuration
- Go to Account > Webhooks
- Confirm webhook is active (toggle on)
- Verify URL is correct and HTTPS
- Check subscribed event types
Step 2: Test Connectivity
- Click Test Webhook
- If successful: endpoint is reachable
- If failed: check below
Step 3: Common Failures
| Symptom | Cause | Fix |
|---|---|---|
| Test fails | Endpoint unreachable | Check URL, DNS, firewall |
| Test fails | SSL/TLS error | Renew/fix certificate |
| Test fails | Non-200 response | Fix endpoint to return 200 |
| Events missing | Wrong event types | Check subscribed events |
| Events missing | No send activity | Events only fire during actual sends |
| Intermittent | Endpoint rate limiting | Increase rate limits or buffer |
| Intermittent | Endpoint timeouts | Increase timeout on your server |
Step 4: Testing Tools
- Use webhook.site for temporary testing
- Inspect payloads and headers
- Verify your endpoint handles the JSON format correctly