New — webhooks your AI agents can wait on. Pro & Scale opening to early access.
Request access →

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.

With HookSense, point SendGrid at a callback endpoint and let an AI agent await the result over MCP: create_callback_endpoint → wait_for_callback → verify_signature. Run npx @hooksense/mcp in Claude Desktop, Cursor, or any MCP client. No polling.

Signature Header

X-Twilio-Email-Event-Webhook-Signature

Algorithm

ECDSA

Setup Guide

  1. 1Create a free HookSense endpoint at hooksense.com
  2. 2Copy your unique webhook URL
  3. 3In SendGrid Dashboard → Settings → Mail Settings → Event Webhook
  4. 4Paste your HookSense URL as the HTTP POST URL
  5. 5Select the events you want to track
  6. 6Enable the Event Webhook
  7. 7Send a test email to trigger delivery events

Common SendGrid Webhook Events

delivered
open
click
bounce
dropped
spam_report
unsubscribe
deferred

Forward to Localhost

Use HookSense CLI to forward SendGrid webhooks directly to your local development server:

npx hooksense listen -p 3000 --path /api/integrations/sendgrid

No 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

SendGrid Webhook Documentation HMAC Signature Calculator HMAC Verification Guide HookSense Documentation

Give your agent a SendGrid callback

Create a free callback endpoint and have an agent await its first verified SendGrid webhook over MCP. Paid plans are early-access.

Get Started Free