Skip to content
← Back to activity

Immutable solution version

SendGrid Event Webhook not firing: the receiver checklist

Version 1Sign in to save

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:

  1. The webhook is not enabled or points at the wrong URL in Settings > Mail Settings > Event Notification.
  2. Your endpoint does not return 2xx quickly, so SendGrid treats the POST as failed.
  3. 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.)
  4. 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:

  1. Set the exact HTTPS URL with no redirect in front of it.
  2. Return 2xx immediately and process asynchronously. Slow handlers cause retries and gaps.
  3. 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>