Skip to content

Test SendGrid webhooks

SendGrid sends event webhooks for email delivery, opens, clicks, bounces, and spam reports. Capture them on a free webhooks.cc endpoint to see exactly what SendGrid sends — or fire realistic sample payloads at your own handler without touching a production account.

Start free:

No credit card · 50 requests/day free · or get a guest URL without an account

Prefer a walkthrough? Read the local webhook testing guide.

How to test SendGrid webhooks

  1. 1

    Create a webhook endpoint

    Sign in free with GitHub or Google to create a persistent endpoint — or grab an instant guest URL at webhooks.cc/go without an account.

  2. 2

    Point SendGrid at your URL

    Paste the endpoint URL into SendGrid: SendGrid → Settings → Mail Settings → Event Webhook.

  3. 3

    Inspect what arrives

    Each delivery appears live in the dashboard with method, headers, body, query parameters, and source IP.

  4. 4

    Forward to localhost or assert in CI

    Run whk tunnel <port> to forward webhooks to a local server, or use the TypeScript SDK to wait for and assert on deliveries in tests.

SendGrid webhook signature

Verification in webhooks.ccCapture deliveries to inspect raw signature material

SendGrid does not use a conventional signature header. Capture a real delivery to inspect exactly what is sent.

New to signature verification? Read the webhook signature verification guide.

Send sample SendGrid events

These SendGrid templates ship with realistic payloads. Send them from the dashboard's Send button, the SDK, or your AI agent via MCP.

deliveredopenbouncespam_report
# Send a signed SendGrid sample with the SDK
await client.endpoints.sendTemplate( slug, {
  provider: "sendgrid",
  template: "delivered",
});

Everything in one place

  • Live dashboard — see deliveries the moment they arrive
  • Forward to localhost with whk tunnel
  • Replay any captured request to any URL
  • Mock responses with custom status, headers, and body
  • TypeScript SDK assertions for CI
  • MCP server for AI coding agents

SendGrid webhook questions

More providers

Browse all 32 providers

Your SendGrid webhook URL is seconds away

Sign up free, create an endpoint, and point SendGrid at it.

No credit card · or try without an account