hookdeck/webhook-skills/sendgrid-webhooks
Claude Code and agent skill by hookdeck/webhook-skills
Trust tier 2
- community
Source check pending
Checking that the SKILL.md file is still in the repository.
Receive and verify SendGrid webhooks. Use when setting up SendGrid webhook handlers, debugging signature verification, or handling email delivery events.
Install
npx vskill@latest install hookdeck/webhook-skills/sendgrid-webhooksSKILL.md
SendGrid Webhooks
When to Use This Skill
- Setting up SendGrid webhook handlers for email delivery tracking
- Debugging ECDSA signature verification failures
- Processing email events (bounce, delivered, open, click, spam report)
- Implementing email engagement analytics
Essential Code
Signature Verification (Manual)
SendGrid uses ECDSA (Elliptic Curve Digital Signature Algorithm) with public key verification.
Using SendGrid SDK
Common Event Types
| Event | Description | Use Cases | |
|---|---|---|---|
processed | Message has been received and is ready to be delivered | Track email processing | |
delivered | Message successfully delivered to recipient | Delivery confirmation | |
bounce | Message permanently rejected (includes type='blocked' for blocked messages) | Update contact lists, handle failures | |
deferred | Temporary delivery failure | Monitor delays | |
open | Recipient opened the email | Engagement tracking | |
click | Recipient clicked a link | Link tracking, CTR analysis | |
spam report | Email marked as spam | List hygiene, sender reputation | |
unsubscribe | Recipient unsubscribed | Update subscription status | |
group unsubscribe | Recipient unsubscribed from a group | Update group subscription preferences | |
group resubscribe | Recipient resubscribed to a group | Update group subscription preferences |
Environment Variables
Local Development
For local webhook testing, use Hookdeck CLI:
No account required. Provides local tunnel + web UI for inspecting requests.
Resources
- overview.md - What SendGrid webhooks are, common event types
- setup.md - Configure webhooks in SendGrid dashboard, get verification key
- verification.md - ECDSA signature verification details and gotchas
- examples/ - Complete implementations for Express, Next.js, and FastAPI
Related Skills
webhook-handler-patterns- Cross-cutting patterns (idempotency, retries, framework guides)- hookdeck-event-gateway - Webhook infrastructure that replaces your queue — guaranteed delivery, automatic retries, replay, rate limiting, and observability for your webhook handlers
Security
- Security scanPassed, 100 of 100Pattern checks on the skill's files.
- Model reviewNot runA model review is scheduled for the next rescan.
Quality evaluation
- Task evaluationNot runNo evaluation yet. Run one in Skill Studio.
Source
- SKILL.md in the repositoryCheckingskills/sendgrid-webhooks/SKILL.md
Popularity
- Repository stars
- 69
- Repository forks
- 7
- 7-day trend score
- 21
Stars and forks are for the whole GitHub repository, not this skill alone. Refreshed 6 May 2026, 6 months ago.
Works with
Any agent vskill installs to: 56 targets in all. These 39 have a page on this site.
- Claude Code
- Cursor
- GitHub Copilot
- Windsurf
- Codex
- Gemini CLI
- Cline
- Amp
- Roo Code
- Goose
- Continue
- Kilo Code
- Junie
- Trae
- OpenHands
- Qwen Code
- AI Agent
- Tabnine Chat
- Sourcegraph Cody
- Amazon Q
- Firebase Genkit
- Sweep
- Devin
- Phind
- Mentat
- Claude Desktop
- Aider
- GPT Pilot
- Plandex
- bolt.new
- v0
- Replit Agent
- Anse
- TypingMind
- BetterChatGPT
- LibreChat
- Warp AI
- Pieces
- Fig AI
Embed badge
[](https://verified-skill.com/skills/hookdeck/webhook-skills/sendgrid-webhooks)