sendgrid-webhooks

What problem does it solve?

SendGrid's Event Webhook provides real-time event data but requires cryptographic verification to ensure authenticity. This Skill standardizes receiving, verifying, and handling SendGrid webhook events across popular web frameworks.

Core Features & Use Cases

• Verify SendGrid signatures using ECDSA with SHA-256 to prevent replay and tampering.
• Receive and process webhook payloads containing multiple events (delivered, bounce, open, click, unsubscribe, etc.) across Express, Next.js, and FastAPI.
• Provide practical examples and guidance to integrate webhook handlers in Node.js and Python environments, including local testing with Hookdeck.

Quick Start

1. Set the environment variable SENDGRID_WEBHOOK_VERIFICATION_KEY to your SendGrid public key.
2. Run or deploy the Express, Next.js, or FastAPI example directories provided under examples/webhooks to expose the /webhooks/sendgrid endpoint.
3. Use a test payload and an EC-SHA256 signature to verify your endpoint responds with 200 and processes events correctly.