# twilio-sendgrid-webhooks

> Claude/Codex skill by [@twilio](https://omgskills.com/library/twilio/index.md) · 37 stars · Updated 2026-10-22

Track email delivery and engagement via SendGrid Event Webhooks. Covers all 11 event types (delivery + engagement), webhook handler implementation, ECDSA signature verification, batched event processing, and common debugging patterns. Use when building SendGrid delivery tracking, engagement analytics, or bounce handling. Requires a SendGrid API key (SG.-prefix) — not applicable to the Twilio Email API (comms.twilio.com).

## Install

```sh
git clone https://github.com/twilio/ai /tmp/ai && ln -s /tmp/ai/skills/sendgrid/twilio-sendgrid-webhooks ~/.claude/skills/twilio-sendgrid-webhooks
```

## From README

Overview The Mail Send API returns 202 Accepted (queued) — it does NOT confirm delivery. To know what happened to an email, use Event Webhooks. Enable: SendGrid Console \> Settings \> Mail Settings \> Event Notification --- Event Types Delivery Events | Event | Meaning | |-------|---------| | processed | SendGrid accepted and will attempt delivery | | deferred | Temporary failure — SendGrid will retry | | delivered | Recipient's mail server accepted the message | | bounce | Permanent failure — address invalid or rejected | | dropped | SendGrid will not deliver (suppression, invalid, spam) | Engagement Events | Event | Meaning | |-------|---------| | open | Recipient opened (pixel-based — unreliable) | | click | Recipient clicked a tracked link | | spamreport | Recipient marked as spam | | unsubscribe | Recipient clicked unsubscribe link | | groupunsubscribe | Recipient unsubscribed from ASM group | | groupresubscribe | Recipient re-subscribed to ASM group | --- Webhook Handler Critical...

## Links

- HTML page: https://omgskills.com/library/twilio/ai/skills/sendgrid/twilio-sendgrid-webhooks/
- GitHub: https://github.com/twilio/ai
- Author: [@twilio](https://omgskills.com/library/twilio/index.md)

## More from this repo

- [twilio-account-setup](https://omgskills.com/library/twilio/ai/skills/twilio/twilio-account-setup/index.md) — Used to create and configure a Twilio account from scratch.
   - [@twilio](https://omgskills.com/library/twilio/index.md) · 37 stars
- [twilio-agent-augmentation-architect](https://omgskills.com/library/twilio/ai/skills/twilio/twilio-agent-augmentation-architect/index.md) — Planning skill for augmenting human agents with real-time AI intelligence.
   - [@twilio](https://omgskills.com/library/twilio/index.md) · 37 stars
- [twilio-ai-agent-architect](https://omgskills.com/library/twilio/ai/skills/twilio/twilio-ai-agent-architect/index.md) — Planning skill for AI-powered conversational agents.
   - [@twilio](https://omgskills.com/library/twilio/index.md) · 37 stars