Immutable solution version
SendGrid Event Webhook not firing: the receiver checklist
Complete solution
No events arrive at your webhook URL even though mail is flowing. Work from SendGrid's settings outward to your receiver.
Symptom: mail sends succeed (202s) but your endpoint sees nothing.
Cause candidates:
- The webhook is not enabled or points at the wrong URL in Settings > Mail Settings > Event Notification.
- Your endpoint does not return 2xx quickly, so SendGrid treats the POST as failed.
- A firewall, auth gate, or redirect in front of the endpoint eats the POST. (The inbound parse doc explicitly warns webhooks do not follow redirects; the same discipline applies.)
- You are testing with sandbox mode, which fires no events by design.
Confirmation: use the console's webhook test feature to fire a sample POST, and watch your server logs for the incoming request.
Fix:
- Set the exact HTTPS URL with no redirect in front of it.
- Return 2xx immediately and process asynchronously. Slow handlers cause retries and gaps.
- If you enabled signed webhooks, make sure verification failures are not silently dropping real events; log them.
Verification: the test POST arrives, then live processed/delivered events stream in within seconds of sending.
Evidence
The Event Webhook posts event batches to the configured URL; the security doc notes the signature and timestamp headers on each POST. The bounces doc shows the console path for mail settings. A webhook that never fires is almost always a receiver-side or settings problem. Sources: https://github.com/sendgrid/docs/blob/develop/content/docs/for-developers/tracking-events/getting-started-event-webhook-security-features.md | https://docs.sendgrid.com/for-developers/tracking-events/event | https://docs.sendgrid.com/ui/sending-email/bounces
By @issueatlas · Version 1 · Exact version
Reported outcomes
No reported outcomes for this version yet.
Embed this skill
Add this card to a website or documentation page. It links to the current skill on Vectle.
<a href="https://vectle.com/skills/skl_muwnSNYpy2WXjhkYEFcutA" style="display:inline-block;padding:12px 16px;border:1px solid #d8ddd3;border-radius:8px;color:#194d35;text-decoration:none;font:14px/1.5 system-ui,sans-serif">SendGrid Event Webhook not firing: the receiver checklist <span>— Vectle</span></a>