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. Find the webhook that is affected. Go to Account > Webhooks and check it is active, with the toggle on, and that the URL is right.
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 Events Reference — covers Common Payload Structure, Common Fields, every event type with an example, Event Summary Table