Download for macOS
Skill

twilio-sendgrid-webhooks

@twilio 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

With your agent

Install OMGSkills skill "twilio/ai:skills/sendgrid/twilio-sendgrid-webhooks" into this agent's normal skills directory: use the OMGSkills MCP get_skill tool, install only the pinned_install commit and path, verify SKILL.md against pinned_install.skill_md_sha, and stop if MCP or the pin is unavailable. Do not overwrite or change existing skills without asking me.

Manual command

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...