Loading...
Loading...
Learn how to track email events with SendGrid webhooks. Monitor deliveries, opens, clicks, bounces, and spam reports in real-time.
SendGrid's Event Webhook sends email event data in near real-time as emails are processed and delivered. This is essential for tracking email deliverability, monitoring engagement, and maintaining list hygiene.
Track whether emails are being delivered: processed, delivered, bounced, dropped, or deferred.
Monitor how recipients interact: opens, clicks, unsubscribes, and spam reports.
processed - Email received by SendGrid and ready to senddelivered - Email accepted by recipient's mail serverbounce - Email rejected by recipient server (hard or soft)dropped - Email not sent (invalid, unsubscribed, bounced before)deferred - Recipient server temporarily unavailable, will retryopen - Recipient opened the email (tracking pixel loaded)click - Recipient clicked a tracked linkunsubscribe - Recipient clicked unsubscribe linkspamreport - Recipient marked email as spamgroup_unsubscribe - Unsubscribed from specific groupGo to Webhook.it and copy your unique webhook URL to capture SendGrid events.
In SendGrid Dashboard, go to Settings > Mail Settings > Event Webhook. Enter your Webhook.it URL in the HTTP POST URL field.
Check the boxes for events you want to receive. For comprehensive tracking, enable all deliverability and engagement events.
Click Enable and use the Test Your Integration button to send a test event. Then send a real email and watch events appear in Webhook.it.
SendGrid sends events as a JSON array. Here's an example with multiple events:
[
{
"email": "customer@example.com",
"timestamp": 1705312200,
"event": "delivered",
"sg_message_id": "abc123.xyz789",
"response": "250 OK",
"category": ["newsletter"]
},
{
"email": "customer@example.com",
"timestamp": 1705312260,
"event": "open",
"sg_message_id": "abc123.xyz789",
"useragent": "Mozilla/5.0...",
"ip": "192.168.1.1"
},
{
"email": "customer@example.com",
"timestamp": 1705312300,
"event": "click",
"sg_message_id": "abc123.xyz789",
"url": "https://example.com/promo"
}
]email - Recipient's email addresstimestamp - Unix timestamp of the eventevent - Event type (delivered, open, click, etc.)sg_message_id - Unique SendGrid message IDcategory - Categories you assigned to the emailurl - Clicked URL (for click events)reason - Bounce/drop reason (for failure events)useragent - Recipient's browser/clientAutomatically remove bounced emails from your list to maintain sender reputation.
Track open rates and click-through rates to measure campaign effectiveness.
Keep your CRM in sync when users unsubscribe via SendGrid's unsubscribe links.
Alert your team when delivery rates drop or bounce rates spike.
SendGrid sends deliverability events (processed, delivered, bounce, dropped, deferred) and engagement events (open, click, spam report, unsubscribe). Each event includes email metadata and timestamp.
In SendGrid Dashboard, go to Settings > Mail Settings > Event Webhook. Enter your webhook URL, select which events to receive, and enable the webhook. SendGrid will POST events to your URL in near real-time.
Use Webhook.it to get a public URL, configure it in SendGrid, then send a test email. You'll see the events (processed, delivered, open, click) appear in real-time as they occur.
Enable Signed Event Webhook in SendGrid settings. SendGrid will include X-Twilio-Email-Event-Webhook-Signature and X-Twilio-Email-Event-Webhook-Timestamp headers. Verify using ECDSA with your verification key.
Open and click tracking must be enabled in your SendGrid account settings. Opens require images to load (blocked by some email clients). Clicks only work for trackable links in HTML emails.