Troubleshooting Webhook Issues

When webhook events stop arriving, the endpoint is usually why: unreachable, not returning a 200, or a certificate that has expired. This page is how to tell that apart from a webhook that is switched off or subscribed to the wrong events.

Instructions

1. Ask which webhook is affected. Navigate to Account > Webhooks and confirm the webhook is active (toggle is on) and the URL is correct.
2. Click Test Webhook to send a test event. If it fails, the endpoint is likely unreachable or returning an error.
3. Verify the endpoint: must be HTTPS, must return HTTP 200, must accept POST requests with JSON body. Check TLS/SSL certificate validity.
4. If test succeeds but events are missing: confirm the correct event types are subscribed. Events only fire for send activity through your Send Integrations.
5. For intermittent failures: check if the endpoint has rate limits, timeouts, or availability issues. EmailElement retries failed webhook deliveries.
6. Use a testing tool like webhook.site to temporarily capture and inspect webhook payloads for debugging.

Related pages

• Webhook Debugging Guide — covers Diagnostic Steps, Step 1: Verify Webhook Configuration, Step 2: Test Connectivity, Step 3: Common Failures
• Webhook Event Types and Payloads — covers Event Types, Base Payload (all events), Event-Specific Fields, Example Payload (Sent)