SendGrid Webhooks
How to Test SendGrid Webhooks Locally (2026)
SendGrid Event Webhooks notify your application about email delivery events like deliveries, opens, clicks, bounces, and spam reports. SendGrid signs webhooks using ECDSA with a verification key.
Signature Header
X-Twilio-Email-Event-Webhook-Signature
Algorithm
ECDSA
Setup Guide
- 1Create a free HookSense endpoint at hooksense.com
- 2Copy your unique webhook URL
- 3In SendGrid Dashboard → Settings → Mail Settings → Event Webhook
- 4Paste your HookSense URL as the HTTP POST URL
- 5Select the events you want to track
- 6Enable the Event Webhook
- 7Send a test email to trigger delivery events
Common SendGrid Webhook Events
deliveredopenclickbouncedroppedspam_reportunsubscribedeferredForward to Localhost
Use HookSense CLI to forward SendGrid webhooks directly to your local development server:
npx hooksense listen -p 3000 --path /api/integrations/sendgridNo ngrok or tunnel setup required. Install with npm i -g hooksense or use npx.
Tips & Best Practices
- SendGrid batches events — a single webhook may contain multiple events in an array
- Use HookSense to inspect the batch structure before writing your parser
- SendGrid events arrive with a delay — HookSense shows the exact timing
- Test bounce handling by sending to a known invalid address
Related
Start Testing SendGrid Webhooks
Create a free endpoint and receive your first SendGrid webhook in seconds.
Get Started Free