[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"skill-openai-twilio-sendgrid-webhooks":3,"mdc-xwubaz-key":36,"related-org-openai-twilio-sendgrid-webhooks":1500,"related-repo-openai-twilio-sendgrid-webhooks":1705},{"slug":4,"name":4,"fn":5,"description":6,"org":7,"tags":11,"stars":25,"repoUrl":26,"updatedAt":27,"license":28,"forks":29,"topics":30,"repo":31,"sourceUrl":34,"mdContent":35},"twilio-sendgrid-webhooks","implement SendGrid email event webhooks","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).\n",{"slug":8,"name":9,"logoUrl":10,"githubOrg":8},"openai","OpenAI","https:\u002F\u002Fpexgzepcugksgbtrxkhf.supabase.co\u002Fstorage\u002Fv1\u002Fobject\u002Fpublic\u002Forg-logos\u002Fopenai.png",[12,16,19,22],{"name":13,"slug":14,"type":15},"SendGrid","sendgrid","tag",{"name":17,"slug":18,"type":15},"API Development","api-development",{"name":20,"slug":21,"type":15},"Webhooks","webhooks",{"name":23,"slug":24,"type":15},"Email","email",3992,"https:\u002F\u002Fgithub.com\u002Fopenai\u002Fplugins","2026-06-30T19:00:57.102",null,465,[],{"repoUrl":26,"stars":25,"forks":29,"topics":32,"description":33},[],"OpenAI Plugins","https:\u002F\u002Fgithub.com\u002Fopenai\u002Fplugins\u002Ftree\u002FHEAD\u002Fplugins\u002Ftwilio-developer-kit\u002Fskills\u002Ftwilio-sendgrid-webhooks","---\nname: twilio-sendgrid-webhooks\ndescription: >\n  Track email delivery and engagement via SendGrid Event Webhooks.\n  Covers all 11 event types (delivery + engagement), webhook handler\n  implementation, ECDSA signature verification, batched event processing,\n  and common debugging patterns. Use when building SendGrid delivery\n  tracking, engagement analytics, or bounce handling. Requires a SendGrid\n  API key (SG.-prefix) — not applicable to the Twilio Email API (comms.twilio.com).\n---\n\n## Overview\n\nThe Mail Send API returns `202 Accepted` (queued) — it does NOT confirm delivery. To know what happened to an email, use Event Webhooks.\n\n**Enable:** SendGrid Console > Settings > Mail Settings > Event Notification\n\n---\n\n## Event Types\n\n### Delivery Events\n| Event | Meaning |\n|-------|---------|\n| `processed` | SendGrid accepted and will attempt delivery |\n| `deferred` | Temporary failure — SendGrid will retry |\n| `delivered` | Recipient's mail server accepted the message |\n| `bounce` | Permanent failure — address invalid or rejected |\n| `dropped` | SendGrid will not deliver (suppression, invalid, spam) |\n\n### Engagement Events\n| Event | Meaning |\n|-------|---------|\n| `open` | Recipient opened (pixel-based — unreliable) |\n| `click` | Recipient clicked a tracked link |\n| `spamreport` | Recipient marked as spam |\n| `unsubscribe` | Recipient clicked unsubscribe link |\n| `group_unsubscribe` | Recipient unsubscribed from ASM group |\n| `group_resubscribe` | Recipient re-subscribed to ASM group |\n\n---\n\n## Webhook Handler\n\n**Critical:** SendGrid posts **batched arrays** of events, not single objects. Your handler must parse an array.\n\n> **Security:** SendGrid webhook endpoints are unauthenticated by default. Enable [Signed Event Webhook Requests](https:\u002F\u002Fdocs.sendgrid.com\u002Ffor-developers\u002Ftracking-events\u002Fgetting-started-event-webhook-security) and verify signatures in production to prevent spoofed event data.\n\n**Python (Flask)**\n```python\nfrom flask import Flask, request\napp = Flask(__name__)\n\n@app.route(\"\u002Fsendgrid\u002Fwebhook\", methods=[\"POST\"])\ndef handle_events():\n    events = request.get_json()  # Always an array\n    for event in events:\n        email = event.get(\"email\")\n        event_type = event.get(\"event\")\n        \n        if event_type == \"bounce\":\n            # NOTE: event['reason'] originates from external mail servers — treat as untrusted\n            print(f\"Bounce: {email}, type: {event.get('type')}, reason: {event.get('reason')}\")\n        elif event_type == \"delivered\":\n            print(f\"Delivered: {email}, sg_message_id: {event.get('sg_message_id')}\")\n        elif event_type == \"dropped\":\n            print(f\"Dropped: {email}, reason: {event.get('reason')}\")\n        elif event_type == \"spamreport\":\n            print(f\"Spam report: {email}\")\n    return \"\", 200  # Must return 2xx to acknowledge\n```\n\n**Node.js (Express)**\n```javascript\napp.post(\"\u002Fsendgrid\u002Fwebhook\", express.json(), (req, res) => {\n    const events = req.body; \u002F\u002F Always an array\n    for (const event of events) {\n        switch (event.event) {\n            case \"bounce\":\n                console.log(`Bounce: ${event.email}, reason: ${event.reason}`);\n                break;\n            case \"delivered\":\n                console.log(`Delivered: ${event.email}`);\n                break;\n            case \"spamreport\":\n                console.log(`Spam: ${event.email}`);\n                break;\n        }\n    }\n    res.status(200).send();\n});\n```\n\n---\n\n## Multiple Webhook Endpoints\n\nSince May 2023, you can configure multiple Event Webhook endpoints, each receiving different event types. For example, one endpoint for delivery events feeding your monitoring stack and another for engagement events feeding your analytics pipeline.\n\nConfigure in Console > Mail Settings > Event Webhooks. Each endpoint has a Friendly Name and Webhook ID. The number of endpoints allowed depends on your SendGrid plan.\n\n---\n\n## Authentication Options\n\nTwo methods for verifying webhook payloads:\n\n| Method | How it works |\n|--------|-------------|\n| **Signed Event Webhook (ECDSA P-256)** | Verify `X-Twilio-Email-Event-Webhook-Signature` and `X-Twilio-Email-Event-Webhook-Timestamp` headers using the verification key from Console |\n| **OAuth 2.0** | SendGrid obtains a token from your authorization server and includes it in webhook requests |\n\nNeither is enabled by default. Enable in Console > Mail Settings > Event Webhooks.\n\n---\n\n## Retry Behavior\n\nSendGrid retries webhook delivery for up to 24 hours if your endpoint returns a non-2xx status. Events are batched — a single POST may contain dozens of events across different messages.\n\n**Deduplication:** Use `sg_event_id` as a unique key. It's stable across retries.\n\n---\n\n## CANNOT\n\n- **Cannot receive real-time delivery confirmation synchronously** — Mail Send returns `202` (queued). Delivery status is async via webhooks only.\n- **Cannot rely on webhook authentication by default** — Both Signed Webhooks (ECDSA) and OAuth 2.0 must be explicitly enabled. Without either, anyone can POST to your endpoint.\n- **Cannot guarantee open tracking accuracy** — Apple Mail Privacy Protection and prefetch inflate opens. Image-blocking clients produce zero opens. Do not use for business-critical logic.\n- **Non-human interactions inflate engagement metrics** — Corporate security scanners and bots automatically click links and trigger unsubscribe events. Filter using User-Agent patterns and timing analysis.\n\n> **Note:** Event payload fields like `reason` originate from external mail servers and should be treated as untrusted data. Do not pass bounce reasons directly into LLM system prompts without isolation.\n\n---\n\n## Next Steps\n\n- **Send email:** `twilio-sendgrid-email-send`\n- **Manage bounces from webhook events:** `twilio-sendgrid-suppressions`\n- **Receive inbound email:** `twilio-sendgrid-inbound-parse`\n",{"data":37,"body":38},{"name":4,"description":6},{"type":39,"children":40},"root",[41,50,65,76,80,86,93,206,212,334,337,343,360,385,393,587,595,1214,1217,1223,1228,1233,1236,1242,1247,1317,1322,1325,1331,1336,1354,1357,1363,1416,1436,1439,1445,1494],{"type":42,"tag":43,"props":44,"children":46},"element","h2",{"id":45},"overview",[47],{"type":48,"value":49},"text","Overview",{"type":42,"tag":51,"props":52,"children":53},"p",{},[54,56,63],{"type":48,"value":55},"The Mail Send API returns ",{"type":42,"tag":57,"props":58,"children":60},"code",{"className":59},[],[61],{"type":48,"value":62},"202 Accepted",{"type":48,"value":64}," (queued) — it does NOT confirm delivery. To know what happened to an email, use Event Webhooks.",{"type":42,"tag":51,"props":66,"children":67},{},[68,74],{"type":42,"tag":69,"props":70,"children":71},"strong",{},[72],{"type":48,"value":73},"Enable:",{"type":48,"value":75}," SendGrid Console > Settings > Mail Settings > Event Notification",{"type":42,"tag":77,"props":78,"children":79},"hr",{},[],{"type":42,"tag":43,"props":81,"children":83},{"id":82},"event-types",[84],{"type":48,"value":85},"Event Types",{"type":42,"tag":87,"props":88,"children":90},"h3",{"id":89},"delivery-events",[91],{"type":48,"value":92},"Delivery Events",{"type":42,"tag":94,"props":95,"children":96},"table",{},[97,116],{"type":42,"tag":98,"props":99,"children":100},"thead",{},[101],{"type":42,"tag":102,"props":103,"children":104},"tr",{},[105,111],{"type":42,"tag":106,"props":107,"children":108},"th",{},[109],{"type":48,"value":110},"Event",{"type":42,"tag":106,"props":112,"children":113},{},[114],{"type":48,"value":115},"Meaning",{"type":42,"tag":117,"props":118,"children":119},"tbody",{},[120,138,155,172,189],{"type":42,"tag":102,"props":121,"children":122},{},[123,133],{"type":42,"tag":124,"props":125,"children":126},"td",{},[127],{"type":42,"tag":57,"props":128,"children":130},{"className":129},[],[131],{"type":48,"value":132},"processed",{"type":42,"tag":124,"props":134,"children":135},{},[136],{"type":48,"value":137},"SendGrid accepted and will attempt delivery",{"type":42,"tag":102,"props":139,"children":140},{},[141,150],{"type":42,"tag":124,"props":142,"children":143},{},[144],{"type":42,"tag":57,"props":145,"children":147},{"className":146},[],[148],{"type":48,"value":149},"deferred",{"type":42,"tag":124,"props":151,"children":152},{},[153],{"type":48,"value":154},"Temporary failure — SendGrid will retry",{"type":42,"tag":102,"props":156,"children":157},{},[158,167],{"type":42,"tag":124,"props":159,"children":160},{},[161],{"type":42,"tag":57,"props":162,"children":164},{"className":163},[],[165],{"type":48,"value":166},"delivered",{"type":42,"tag":124,"props":168,"children":169},{},[170],{"type":48,"value":171},"Recipient's mail server accepted the message",{"type":42,"tag":102,"props":173,"children":174},{},[175,184],{"type":42,"tag":124,"props":176,"children":177},{},[178],{"type":42,"tag":57,"props":179,"children":181},{"className":180},[],[182],{"type":48,"value":183},"bounce",{"type":42,"tag":124,"props":185,"children":186},{},[187],{"type":48,"value":188},"Permanent failure — address invalid or rejected",{"type":42,"tag":102,"props":190,"children":191},{},[192,201],{"type":42,"tag":124,"props":193,"children":194},{},[195],{"type":42,"tag":57,"props":196,"children":198},{"className":197},[],[199],{"type":48,"value":200},"dropped",{"type":42,"tag":124,"props":202,"children":203},{},[204],{"type":48,"value":205},"SendGrid will not deliver (suppression, invalid, spam)",{"type":42,"tag":87,"props":207,"children":209},{"id":208},"engagement-events",[210],{"type":48,"value":211},"Engagement Events",{"type":42,"tag":94,"props":213,"children":214},{},[215,229],{"type":42,"tag":98,"props":216,"children":217},{},[218],{"type":42,"tag":102,"props":219,"children":220},{},[221,225],{"type":42,"tag":106,"props":222,"children":223},{},[224],{"type":48,"value":110},{"type":42,"tag":106,"props":226,"children":227},{},[228],{"type":48,"value":115},{"type":42,"tag":117,"props":230,"children":231},{},[232,249,266,283,300,317],{"type":42,"tag":102,"props":233,"children":234},{},[235,244],{"type":42,"tag":124,"props":236,"children":237},{},[238],{"type":42,"tag":57,"props":239,"children":241},{"className":240},[],[242],{"type":48,"value":243},"open",{"type":42,"tag":124,"props":245,"children":246},{},[247],{"type":48,"value":248},"Recipient opened (pixel-based — unreliable)",{"type":42,"tag":102,"props":250,"children":251},{},[252,261],{"type":42,"tag":124,"props":253,"children":254},{},[255],{"type":42,"tag":57,"props":256,"children":258},{"className":257},[],[259],{"type":48,"value":260},"click",{"type":42,"tag":124,"props":262,"children":263},{},[264],{"type":48,"value":265},"Recipient clicked a tracked link",{"type":42,"tag":102,"props":267,"children":268},{},[269,278],{"type":42,"tag":124,"props":270,"children":271},{},[272],{"type":42,"tag":57,"props":273,"children":275},{"className":274},[],[276],{"type":48,"value":277},"spamreport",{"type":42,"tag":124,"props":279,"children":280},{},[281],{"type":48,"value":282},"Recipient marked as spam",{"type":42,"tag":102,"props":284,"children":285},{},[286,295],{"type":42,"tag":124,"props":287,"children":288},{},[289],{"type":42,"tag":57,"props":290,"children":292},{"className":291},[],[293],{"type":48,"value":294},"unsubscribe",{"type":42,"tag":124,"props":296,"children":297},{},[298],{"type":48,"value":299},"Recipient clicked unsubscribe link",{"type":42,"tag":102,"props":301,"children":302},{},[303,312],{"type":42,"tag":124,"props":304,"children":305},{},[306],{"type":42,"tag":57,"props":307,"children":309},{"className":308},[],[310],{"type":48,"value":311},"group_unsubscribe",{"type":42,"tag":124,"props":313,"children":314},{},[315],{"type":48,"value":316},"Recipient unsubscribed from ASM group",{"type":42,"tag":102,"props":318,"children":319},{},[320,329],{"type":42,"tag":124,"props":321,"children":322},{},[323],{"type":42,"tag":57,"props":324,"children":326},{"className":325},[],[327],{"type":48,"value":328},"group_resubscribe",{"type":42,"tag":124,"props":330,"children":331},{},[332],{"type":48,"value":333},"Recipient re-subscribed to ASM group",{"type":42,"tag":77,"props":335,"children":336},{},[],{"type":42,"tag":43,"props":338,"children":340},{"id":339},"webhook-handler",[341],{"type":48,"value":342},"Webhook Handler",{"type":42,"tag":51,"props":344,"children":345},{},[346,351,353,358],{"type":42,"tag":69,"props":347,"children":348},{},[349],{"type":48,"value":350},"Critical:",{"type":48,"value":352}," SendGrid posts ",{"type":42,"tag":69,"props":354,"children":355},{},[356],{"type":48,"value":357},"batched arrays",{"type":48,"value":359}," of events, not single objects. Your handler must parse an array.",{"type":42,"tag":361,"props":362,"children":363},"blockquote",{},[364],{"type":42,"tag":51,"props":365,"children":366},{},[367,372,374,383],{"type":42,"tag":69,"props":368,"children":369},{},[370],{"type":48,"value":371},"Security:",{"type":48,"value":373}," SendGrid webhook endpoints are unauthenticated by default. Enable ",{"type":42,"tag":375,"props":376,"children":380},"a",{"href":377,"rel":378},"https:\u002F\u002Fdocs.sendgrid.com\u002Ffor-developers\u002Ftracking-events\u002Fgetting-started-event-webhook-security",[379],"nofollow",[381],{"type":48,"value":382},"Signed Event Webhook Requests",{"type":48,"value":384}," and verify signatures in production to prevent spoofed event data.",{"type":42,"tag":51,"props":386,"children":387},{},[388],{"type":42,"tag":69,"props":389,"children":390},{},[391],{"type":48,"value":392},"Python (Flask)",{"type":42,"tag":394,"props":395,"children":400},"pre",{"className":396,"code":397,"language":398,"meta":399,"style":399},"language-python shiki shiki-themes material-theme-lighter material-theme material-theme-palenight","from flask import Flask, request\napp = Flask(__name__)\n\n@app.route(\"\u002Fsendgrid\u002Fwebhook\", methods=[\"POST\"])\ndef handle_events():\n    events = request.get_json()  # Always an array\n    for event in events:\n        email = event.get(\"email\")\n        event_type = event.get(\"event\")\n        \n        if event_type == \"bounce\":\n            # NOTE: event['reason'] originates from external mail servers — treat as untrusted\n            print(f\"Bounce: {email}, type: {event.get('type')}, reason: {event.get('reason')}\")\n        elif event_type == \"delivered\":\n            print(f\"Delivered: {email}, sg_message_id: {event.get('sg_message_id')}\")\n        elif event_type == \"dropped\":\n            print(f\"Dropped: {email}, reason: {event.get('reason')}\")\n        elif event_type == \"spamreport\":\n            print(f\"Spam report: {email}\")\n    return \"\", 200  # Must return 2xx to acknowledge\n","python","",[401],{"type":42,"tag":57,"props":402,"children":403},{"__ignoreMap":399},[404,415,424,434,443,452,461,470,479,488,497,506,515,524,533,542,551,560,569,578],{"type":42,"tag":405,"props":406,"children":409},"span",{"class":407,"line":408},"line",1,[410],{"type":42,"tag":405,"props":411,"children":412},{},[413],{"type":48,"value":414},"from flask import Flask, request\n",{"type":42,"tag":405,"props":416,"children":418},{"class":407,"line":417},2,[419],{"type":42,"tag":405,"props":420,"children":421},{},[422],{"type":48,"value":423},"app = Flask(__name__)\n",{"type":42,"tag":405,"props":425,"children":427},{"class":407,"line":426},3,[428],{"type":42,"tag":405,"props":429,"children":431},{"emptyLinePlaceholder":430},true,[432],{"type":48,"value":433},"\n",{"type":42,"tag":405,"props":435,"children":437},{"class":407,"line":436},4,[438],{"type":42,"tag":405,"props":439,"children":440},{},[441],{"type":48,"value":442},"@app.route(\"\u002Fsendgrid\u002Fwebhook\", methods=[\"POST\"])\n",{"type":42,"tag":405,"props":444,"children":446},{"class":407,"line":445},5,[447],{"type":42,"tag":405,"props":448,"children":449},{},[450],{"type":48,"value":451},"def handle_events():\n",{"type":42,"tag":405,"props":453,"children":455},{"class":407,"line":454},6,[456],{"type":42,"tag":405,"props":457,"children":458},{},[459],{"type":48,"value":460},"    events = request.get_json()  # Always an array\n",{"type":42,"tag":405,"props":462,"children":464},{"class":407,"line":463},7,[465],{"type":42,"tag":405,"props":466,"children":467},{},[468],{"type":48,"value":469},"    for event in events:\n",{"type":42,"tag":405,"props":471,"children":473},{"class":407,"line":472},8,[474],{"type":42,"tag":405,"props":475,"children":476},{},[477],{"type":48,"value":478},"        email = event.get(\"email\")\n",{"type":42,"tag":405,"props":480,"children":482},{"class":407,"line":481},9,[483],{"type":42,"tag":405,"props":484,"children":485},{},[486],{"type":48,"value":487},"        event_type = event.get(\"event\")\n",{"type":42,"tag":405,"props":489,"children":491},{"class":407,"line":490},10,[492],{"type":42,"tag":405,"props":493,"children":494},{},[495],{"type":48,"value":496},"        \n",{"type":42,"tag":405,"props":498,"children":500},{"class":407,"line":499},11,[501],{"type":42,"tag":405,"props":502,"children":503},{},[504],{"type":48,"value":505},"        if event_type == \"bounce\":\n",{"type":42,"tag":405,"props":507,"children":509},{"class":407,"line":508},12,[510],{"type":42,"tag":405,"props":511,"children":512},{},[513],{"type":48,"value":514},"            # NOTE: event['reason'] originates from external mail servers — treat as untrusted\n",{"type":42,"tag":405,"props":516,"children":518},{"class":407,"line":517},13,[519],{"type":42,"tag":405,"props":520,"children":521},{},[522],{"type":48,"value":523},"            print(f\"Bounce: {email}, type: {event.get('type')}, reason: {event.get('reason')}\")\n",{"type":42,"tag":405,"props":525,"children":527},{"class":407,"line":526},14,[528],{"type":42,"tag":405,"props":529,"children":530},{},[531],{"type":48,"value":532},"        elif event_type == \"delivered\":\n",{"type":42,"tag":405,"props":534,"children":536},{"class":407,"line":535},15,[537],{"type":42,"tag":405,"props":538,"children":539},{},[540],{"type":48,"value":541},"            print(f\"Delivered: {email}, sg_message_id: {event.get('sg_message_id')}\")\n",{"type":42,"tag":405,"props":543,"children":545},{"class":407,"line":544},16,[546],{"type":42,"tag":405,"props":547,"children":548},{},[549],{"type":48,"value":550},"        elif event_type == \"dropped\":\n",{"type":42,"tag":405,"props":552,"children":554},{"class":407,"line":553},17,[555],{"type":42,"tag":405,"props":556,"children":557},{},[558],{"type":48,"value":559},"            print(f\"Dropped: {email}, reason: {event.get('reason')}\")\n",{"type":42,"tag":405,"props":561,"children":563},{"class":407,"line":562},18,[564],{"type":42,"tag":405,"props":565,"children":566},{},[567],{"type":48,"value":568},"        elif event_type == \"spamreport\":\n",{"type":42,"tag":405,"props":570,"children":572},{"class":407,"line":571},19,[573],{"type":42,"tag":405,"props":574,"children":575},{},[576],{"type":48,"value":577},"            print(f\"Spam report: {email}\")\n",{"type":42,"tag":405,"props":579,"children":581},{"class":407,"line":580},20,[582],{"type":42,"tag":405,"props":583,"children":584},{},[585],{"type":48,"value":586},"    return \"\", 200  # Must return 2xx to acknowledge\n",{"type":42,"tag":51,"props":588,"children":589},{},[590],{"type":42,"tag":69,"props":591,"children":592},{},[593],{"type":48,"value":594},"Node.js (Express)",{"type":42,"tag":394,"props":596,"children":600},{"className":597,"code":598,"language":599,"meta":399,"style":399},"language-javascript shiki shiki-themes material-theme-lighter material-theme material-theme-palenight","app.post(\"\u002Fsendgrid\u002Fwebhook\", express.json(), (req, res) => {\n    const events = req.body; \u002F\u002F Always an array\n    for (const event of events) {\n        switch (event.event) {\n            case \"bounce\":\n                console.log(`Bounce: ${event.email}, reason: ${event.reason}`);\n                break;\n            case \"delivered\":\n                console.log(`Delivered: ${event.email}`);\n                break;\n            case \"spamreport\":\n                console.log(`Spam: ${event.email}`);\n                break;\n        }\n    }\n    res.status(200).send();\n});\n","javascript",[601],{"type":42,"tag":57,"props":602,"children":603},{"__ignoreMap":399},[604,709,752,795,828,854,943,955,978,1034,1045,1068,1124,1135,1143,1151,1199],{"type":42,"tag":405,"props":605,"children":606},{"class":407,"line":408},[607,613,619,625,630,635,641,645,650,655,659,664,669,673,678,684,688,693,698,704],{"type":42,"tag":405,"props":608,"children":610},{"style":609},"--shiki-light:#90A4AE;--shiki-default:#EEFFFF;--shiki-dark:#BABED8",[611],{"type":48,"value":612},"app",{"type":42,"tag":405,"props":614,"children":616},{"style":615},"--shiki-light:#39ADB5;--shiki-default:#89DDFF;--shiki-dark:#89DDFF",[617],{"type":48,"value":618},".",{"type":42,"tag":405,"props":620,"children":622},{"style":621},"--shiki-light:#6182B8;--shiki-default:#82AAFF;--shiki-dark:#82AAFF",[623],{"type":48,"value":624},"post",{"type":42,"tag":405,"props":626,"children":627},{"style":609},[628],{"type":48,"value":629},"(",{"type":42,"tag":405,"props":631,"children":632},{"style":615},[633],{"type":48,"value":634},"\"",{"type":42,"tag":405,"props":636,"children":638},{"style":637},"--shiki-light:#91B859;--shiki-default:#C3E88D;--shiki-dark:#C3E88D",[639],{"type":48,"value":640},"\u002Fsendgrid\u002Fwebhook",{"type":42,"tag":405,"props":642,"children":643},{"style":615},[644],{"type":48,"value":634},{"type":42,"tag":405,"props":646,"children":647},{"style":615},[648],{"type":48,"value":649},",",{"type":42,"tag":405,"props":651,"children":652},{"style":609},[653],{"type":48,"value":654}," express",{"type":42,"tag":405,"props":656,"children":657},{"style":615},[658],{"type":48,"value":618},{"type":42,"tag":405,"props":660,"children":661},{"style":621},[662],{"type":48,"value":663},"json",{"type":42,"tag":405,"props":665,"children":666},{"style":609},[667],{"type":48,"value":668},"()",{"type":42,"tag":405,"props":670,"children":671},{"style":615},[672],{"type":48,"value":649},{"type":42,"tag":405,"props":674,"children":675},{"style":615},[676],{"type":48,"value":677}," (",{"type":42,"tag":405,"props":679,"children":681},{"style":680},"--shiki-light:#90A4AE;--shiki-light-font-style:italic;--shiki-default:#EEFFFF;--shiki-default-font-style:italic;--shiki-dark:#BABED8;--shiki-dark-font-style:italic",[682],{"type":48,"value":683},"req",{"type":42,"tag":405,"props":685,"children":686},{"style":615},[687],{"type":48,"value":649},{"type":42,"tag":405,"props":689,"children":690},{"style":680},[691],{"type":48,"value":692}," res",{"type":42,"tag":405,"props":694,"children":695},{"style":615},[696],{"type":48,"value":697},")",{"type":42,"tag":405,"props":699,"children":701},{"style":700},"--shiki-light:#9C3EDA;--shiki-default:#C792EA;--shiki-dark:#C792EA",[702],{"type":48,"value":703}," =>",{"type":42,"tag":405,"props":705,"children":706},{"style":615},[707],{"type":48,"value":708}," {\n",{"type":42,"tag":405,"props":710,"children":711},{"class":407,"line":417},[712,717,722,727,732,736,741,746],{"type":42,"tag":405,"props":713,"children":714},{"style":700},[715],{"type":48,"value":716},"    const",{"type":42,"tag":405,"props":718,"children":719},{"style":609},[720],{"type":48,"value":721}," events",{"type":42,"tag":405,"props":723,"children":724},{"style":615},[725],{"type":48,"value":726}," =",{"type":42,"tag":405,"props":728,"children":729},{"style":609},[730],{"type":48,"value":731}," req",{"type":42,"tag":405,"props":733,"children":734},{"style":615},[735],{"type":48,"value":618},{"type":42,"tag":405,"props":737,"children":738},{"style":609},[739],{"type":48,"value":740},"body",{"type":42,"tag":405,"props":742,"children":743},{"style":615},[744],{"type":48,"value":745},";",{"type":42,"tag":405,"props":747,"children":749},{"style":748},"--shiki-light:#90A4AE;--shiki-light-font-style:italic;--shiki-default:#546E7A;--shiki-default-font-style:italic;--shiki-dark:#676E95;--shiki-dark-font-style:italic",[750],{"type":48,"value":751}," \u002F\u002F Always an array\n",{"type":42,"tag":405,"props":753,"children":754},{"class":407,"line":426},[755,761,766,771,776,781,785,790],{"type":42,"tag":405,"props":756,"children":758},{"style":757},"--shiki-light:#39ADB5;--shiki-light-font-style:italic;--shiki-default:#89DDFF;--shiki-default-font-style:italic;--shiki-dark:#89DDFF;--shiki-dark-font-style:italic",[759],{"type":48,"value":760},"    for",{"type":42,"tag":405,"props":762,"children":764},{"style":763},"--shiki-light:#E53935;--shiki-default:#F07178;--shiki-dark:#F07178",[765],{"type":48,"value":677},{"type":42,"tag":405,"props":767,"children":768},{"style":700},[769],{"type":48,"value":770},"const",{"type":42,"tag":405,"props":772,"children":773},{"style":609},[774],{"type":48,"value":775}," event",{"type":42,"tag":405,"props":777,"children":778},{"style":615},[779],{"type":48,"value":780}," of",{"type":42,"tag":405,"props":782,"children":783},{"style":609},[784],{"type":48,"value":721},{"type":42,"tag":405,"props":786,"children":787},{"style":763},[788],{"type":48,"value":789},") ",{"type":42,"tag":405,"props":791,"children":792},{"style":615},[793],{"type":48,"value":794},"{\n",{"type":42,"tag":405,"props":796,"children":797},{"class":407,"line":436},[798,803,807,812,816,820,824],{"type":42,"tag":405,"props":799,"children":800},{"style":757},[801],{"type":48,"value":802},"        switch",{"type":42,"tag":405,"props":804,"children":805},{"style":763},[806],{"type":48,"value":677},{"type":42,"tag":405,"props":808,"children":809},{"style":609},[810],{"type":48,"value":811},"event",{"type":42,"tag":405,"props":813,"children":814},{"style":615},[815],{"type":48,"value":618},{"type":42,"tag":405,"props":817,"children":818},{"style":609},[819],{"type":48,"value":811},{"type":42,"tag":405,"props":821,"children":822},{"style":763},[823],{"type":48,"value":789},{"type":42,"tag":405,"props":825,"children":826},{"style":615},[827],{"type":48,"value":794},{"type":42,"tag":405,"props":829,"children":830},{"class":407,"line":445},[831,836,841,845,849],{"type":42,"tag":405,"props":832,"children":833},{"style":757},[834],{"type":48,"value":835},"            case",{"type":42,"tag":405,"props":837,"children":838},{"style":615},[839],{"type":48,"value":840}," \"",{"type":42,"tag":405,"props":842,"children":843},{"style":637},[844],{"type":48,"value":183},{"type":42,"tag":405,"props":846,"children":847},{"style":615},[848],{"type":48,"value":634},{"type":42,"tag":405,"props":850,"children":851},{"style":615},[852],{"type":48,"value":853},":\n",{"type":42,"tag":405,"props":855,"children":856},{"class":407,"line":454},[857,862,866,871,875,880,885,890,894,898,902,907,912,916,920,924,929,934,938],{"type":42,"tag":405,"props":858,"children":859},{"style":609},[860],{"type":48,"value":861},"                console",{"type":42,"tag":405,"props":863,"children":864},{"style":615},[865],{"type":48,"value":618},{"type":42,"tag":405,"props":867,"children":868},{"style":621},[869],{"type":48,"value":870},"log",{"type":42,"tag":405,"props":872,"children":873},{"style":763},[874],{"type":48,"value":629},{"type":42,"tag":405,"props":876,"children":877},{"style":615},[878],{"type":48,"value":879},"`",{"type":42,"tag":405,"props":881,"children":882},{"style":637},[883],{"type":48,"value":884},"Bounce: ",{"type":42,"tag":405,"props":886,"children":887},{"style":615},[888],{"type":48,"value":889},"${",{"type":42,"tag":405,"props":891,"children":892},{"style":609},[893],{"type":48,"value":811},{"type":42,"tag":405,"props":895,"children":896},{"style":615},[897],{"type":48,"value":618},{"type":42,"tag":405,"props":899,"children":900},{"style":609},[901],{"type":48,"value":24},{"type":42,"tag":405,"props":903,"children":904},{"style":615},[905],{"type":48,"value":906},"}",{"type":42,"tag":405,"props":908,"children":909},{"style":637},[910],{"type":48,"value":911},", reason: ",{"type":42,"tag":405,"props":913,"children":914},{"style":615},[915],{"type":48,"value":889},{"type":42,"tag":405,"props":917,"children":918},{"style":609},[919],{"type":48,"value":811},{"type":42,"tag":405,"props":921,"children":922},{"style":615},[923],{"type":48,"value":618},{"type":42,"tag":405,"props":925,"children":926},{"style":609},[927],{"type":48,"value":928},"reason",{"type":42,"tag":405,"props":930,"children":931},{"style":615},[932],{"type":48,"value":933},"}`",{"type":42,"tag":405,"props":935,"children":936},{"style":763},[937],{"type":48,"value":697},{"type":42,"tag":405,"props":939,"children":940},{"style":615},[941],{"type":48,"value":942},";\n",{"type":42,"tag":405,"props":944,"children":945},{"class":407,"line":463},[946,951],{"type":42,"tag":405,"props":947,"children":948},{"style":757},[949],{"type":48,"value":950},"                break",{"type":42,"tag":405,"props":952,"children":953},{"style":615},[954],{"type":48,"value":942},{"type":42,"tag":405,"props":956,"children":957},{"class":407,"line":472},[958,962,966,970,974],{"type":42,"tag":405,"props":959,"children":960},{"style":757},[961],{"type":48,"value":835},{"type":42,"tag":405,"props":963,"children":964},{"style":615},[965],{"type":48,"value":840},{"type":42,"tag":405,"props":967,"children":968},{"style":637},[969],{"type":48,"value":166},{"type":42,"tag":405,"props":971,"children":972},{"style":615},[973],{"type":48,"value":634},{"type":42,"tag":405,"props":975,"children":976},{"style":615},[977],{"type":48,"value":853},{"type":42,"tag":405,"props":979,"children":980},{"class":407,"line":481},[981,985,989,993,997,1001,1006,1010,1014,1018,1022,1026,1030],{"type":42,"tag":405,"props":982,"children":983},{"style":609},[984],{"type":48,"value":861},{"type":42,"tag":405,"props":986,"children":987},{"style":615},[988],{"type":48,"value":618},{"type":42,"tag":405,"props":990,"children":991},{"style":621},[992],{"type":48,"value":870},{"type":42,"tag":405,"props":994,"children":995},{"style":763},[996],{"type":48,"value":629},{"type":42,"tag":405,"props":998,"children":999},{"style":615},[1000],{"type":48,"value":879},{"type":42,"tag":405,"props":1002,"children":1003},{"style":637},[1004],{"type":48,"value":1005},"Delivered: ",{"type":42,"tag":405,"props":1007,"children":1008},{"style":615},[1009],{"type":48,"value":889},{"type":42,"tag":405,"props":1011,"children":1012},{"style":609},[1013],{"type":48,"value":811},{"type":42,"tag":405,"props":1015,"children":1016},{"style":615},[1017],{"type":48,"value":618},{"type":42,"tag":405,"props":1019,"children":1020},{"style":609},[1021],{"type":48,"value":24},{"type":42,"tag":405,"props":1023,"children":1024},{"style":615},[1025],{"type":48,"value":933},{"type":42,"tag":405,"props":1027,"children":1028},{"style":763},[1029],{"type":48,"value":697},{"type":42,"tag":405,"props":1031,"children":1032},{"style":615},[1033],{"type":48,"value":942},{"type":42,"tag":405,"props":1035,"children":1036},{"class":407,"line":490},[1037,1041],{"type":42,"tag":405,"props":1038,"children":1039},{"style":757},[1040],{"type":48,"value":950},{"type":42,"tag":405,"props":1042,"children":1043},{"style":615},[1044],{"type":48,"value":942},{"type":42,"tag":405,"props":1046,"children":1047},{"class":407,"line":499},[1048,1052,1056,1060,1064],{"type":42,"tag":405,"props":1049,"children":1050},{"style":757},[1051],{"type":48,"value":835},{"type":42,"tag":405,"props":1053,"children":1054},{"style":615},[1055],{"type":48,"value":840},{"type":42,"tag":405,"props":1057,"children":1058},{"style":637},[1059],{"type":48,"value":277},{"type":42,"tag":405,"props":1061,"children":1062},{"style":615},[1063],{"type":48,"value":634},{"type":42,"tag":405,"props":1065,"children":1066},{"style":615},[1067],{"type":48,"value":853},{"type":42,"tag":405,"props":1069,"children":1070},{"class":407,"line":508},[1071,1075,1079,1083,1087,1091,1096,1100,1104,1108,1112,1116,1120],{"type":42,"tag":405,"props":1072,"children":1073},{"style":609},[1074],{"type":48,"value":861},{"type":42,"tag":405,"props":1076,"children":1077},{"style":615},[1078],{"type":48,"value":618},{"type":42,"tag":405,"props":1080,"children":1081},{"style":621},[1082],{"type":48,"value":870},{"type":42,"tag":405,"props":1084,"children":1085},{"style":763},[1086],{"type":48,"value":629},{"type":42,"tag":405,"props":1088,"children":1089},{"style":615},[1090],{"type":48,"value":879},{"type":42,"tag":405,"props":1092,"children":1093},{"style":637},[1094],{"type":48,"value":1095},"Spam: ",{"type":42,"tag":405,"props":1097,"children":1098},{"style":615},[1099],{"type":48,"value":889},{"type":42,"tag":405,"props":1101,"children":1102},{"style":609},[1103],{"type":48,"value":811},{"type":42,"tag":405,"props":1105,"children":1106},{"style":615},[1107],{"type":48,"value":618},{"type":42,"tag":405,"props":1109,"children":1110},{"style":609},[1111],{"type":48,"value":24},{"type":42,"tag":405,"props":1113,"children":1114},{"style":615},[1115],{"type":48,"value":933},{"type":42,"tag":405,"props":1117,"children":1118},{"style":763},[1119],{"type":48,"value":697},{"type":42,"tag":405,"props":1121,"children":1122},{"style":615},[1123],{"type":48,"value":942},{"type":42,"tag":405,"props":1125,"children":1126},{"class":407,"line":517},[1127,1131],{"type":42,"tag":405,"props":1128,"children":1129},{"style":757},[1130],{"type":48,"value":950},{"type":42,"tag":405,"props":1132,"children":1133},{"style":615},[1134],{"type":48,"value":942},{"type":42,"tag":405,"props":1136,"children":1137},{"class":407,"line":526},[1138],{"type":42,"tag":405,"props":1139,"children":1140},{"style":615},[1141],{"type":48,"value":1142},"        }\n",{"type":42,"tag":405,"props":1144,"children":1145},{"class":407,"line":535},[1146],{"type":42,"tag":405,"props":1147,"children":1148},{"style":615},[1149],{"type":48,"value":1150},"    }\n",{"type":42,"tag":405,"props":1152,"children":1153},{"class":407,"line":544},[1154,1159,1163,1168,1172,1178,1182,1186,1191,1195],{"type":42,"tag":405,"props":1155,"children":1156},{"style":609},[1157],{"type":48,"value":1158},"    res",{"type":42,"tag":405,"props":1160,"children":1161},{"style":615},[1162],{"type":48,"value":618},{"type":42,"tag":405,"props":1164,"children":1165},{"style":621},[1166],{"type":48,"value":1167},"status",{"type":42,"tag":405,"props":1169,"children":1170},{"style":763},[1171],{"type":48,"value":629},{"type":42,"tag":405,"props":1173,"children":1175},{"style":1174},"--shiki-light:#F76D47;--shiki-default:#F78C6C;--shiki-dark:#F78C6C",[1176],{"type":48,"value":1177},"200",{"type":42,"tag":405,"props":1179,"children":1180},{"style":763},[1181],{"type":48,"value":697},{"type":42,"tag":405,"props":1183,"children":1184},{"style":615},[1185],{"type":48,"value":618},{"type":42,"tag":405,"props":1187,"children":1188},{"style":621},[1189],{"type":48,"value":1190},"send",{"type":42,"tag":405,"props":1192,"children":1193},{"style":763},[1194],{"type":48,"value":668},{"type":42,"tag":405,"props":1196,"children":1197},{"style":615},[1198],{"type":48,"value":942},{"type":42,"tag":405,"props":1200,"children":1201},{"class":407,"line":553},[1202,1206,1210],{"type":42,"tag":405,"props":1203,"children":1204},{"style":615},[1205],{"type":48,"value":906},{"type":42,"tag":405,"props":1207,"children":1208},{"style":609},[1209],{"type":48,"value":697},{"type":42,"tag":405,"props":1211,"children":1212},{"style":615},[1213],{"type":48,"value":942},{"type":42,"tag":77,"props":1215,"children":1216},{},[],{"type":42,"tag":43,"props":1218,"children":1220},{"id":1219},"multiple-webhook-endpoints",[1221],{"type":48,"value":1222},"Multiple Webhook Endpoints",{"type":42,"tag":51,"props":1224,"children":1225},{},[1226],{"type":48,"value":1227},"Since May 2023, you can configure multiple Event Webhook endpoints, each receiving different event types. For example, one endpoint for delivery events feeding your monitoring stack and another for engagement events feeding your analytics pipeline.",{"type":42,"tag":51,"props":1229,"children":1230},{},[1231],{"type":48,"value":1232},"Configure in Console > Mail Settings > Event Webhooks. Each endpoint has a Friendly Name and Webhook ID. The number of endpoints allowed depends on your SendGrid plan.",{"type":42,"tag":77,"props":1234,"children":1235},{},[],{"type":42,"tag":43,"props":1237,"children":1239},{"id":1238},"authentication-options",[1240],{"type":48,"value":1241},"Authentication Options",{"type":42,"tag":51,"props":1243,"children":1244},{},[1245],{"type":48,"value":1246},"Two methods for verifying webhook payloads:",{"type":42,"tag":94,"props":1248,"children":1249},{},[1250,1266],{"type":42,"tag":98,"props":1251,"children":1252},{},[1253],{"type":42,"tag":102,"props":1254,"children":1255},{},[1256,1261],{"type":42,"tag":106,"props":1257,"children":1258},{},[1259],{"type":48,"value":1260},"Method",{"type":42,"tag":106,"props":1262,"children":1263},{},[1264],{"type":48,"value":1265},"How it works",{"type":42,"tag":117,"props":1267,"children":1268},{},[1269,1301],{"type":42,"tag":102,"props":1270,"children":1271},{},[1272,1280],{"type":42,"tag":124,"props":1273,"children":1274},{},[1275],{"type":42,"tag":69,"props":1276,"children":1277},{},[1278],{"type":48,"value":1279},"Signed Event Webhook (ECDSA P-256)",{"type":42,"tag":124,"props":1281,"children":1282},{},[1283,1285,1291,1293,1299],{"type":48,"value":1284},"Verify ",{"type":42,"tag":57,"props":1286,"children":1288},{"className":1287},[],[1289],{"type":48,"value":1290},"X-Twilio-Email-Event-Webhook-Signature",{"type":48,"value":1292}," and ",{"type":42,"tag":57,"props":1294,"children":1296},{"className":1295},[],[1297],{"type":48,"value":1298},"X-Twilio-Email-Event-Webhook-Timestamp",{"type":48,"value":1300}," headers using the verification key from Console",{"type":42,"tag":102,"props":1302,"children":1303},{},[1304,1312],{"type":42,"tag":124,"props":1305,"children":1306},{},[1307],{"type":42,"tag":69,"props":1308,"children":1309},{},[1310],{"type":48,"value":1311},"OAuth 2.0",{"type":42,"tag":124,"props":1313,"children":1314},{},[1315],{"type":48,"value":1316},"SendGrid obtains a token from your authorization server and includes it in webhook requests",{"type":42,"tag":51,"props":1318,"children":1319},{},[1320],{"type":48,"value":1321},"Neither is enabled by default. Enable in Console > Mail Settings > Event Webhooks.",{"type":42,"tag":77,"props":1323,"children":1324},{},[],{"type":42,"tag":43,"props":1326,"children":1328},{"id":1327},"retry-behavior",[1329],{"type":48,"value":1330},"Retry Behavior",{"type":42,"tag":51,"props":1332,"children":1333},{},[1334],{"type":48,"value":1335},"SendGrid retries webhook delivery for up to 24 hours if your endpoint returns a non-2xx status. Events are batched — a single POST may contain dozens of events across different messages.",{"type":42,"tag":51,"props":1337,"children":1338},{},[1339,1344,1346,1352],{"type":42,"tag":69,"props":1340,"children":1341},{},[1342],{"type":48,"value":1343},"Deduplication:",{"type":48,"value":1345}," Use ",{"type":42,"tag":57,"props":1347,"children":1349},{"className":1348},[],[1350],{"type":48,"value":1351},"sg_event_id",{"type":48,"value":1353}," as a unique key. It's stable across retries.",{"type":42,"tag":77,"props":1355,"children":1356},{},[],{"type":42,"tag":43,"props":1358,"children":1360},{"id":1359},"cannot",[1361],{"type":48,"value":1362},"CANNOT",{"type":42,"tag":1364,"props":1365,"children":1366},"ul",{},[1367,1386,1396,1406],{"type":42,"tag":1368,"props":1369,"children":1370},"li",{},[1371,1376,1378,1384],{"type":42,"tag":69,"props":1372,"children":1373},{},[1374],{"type":48,"value":1375},"Cannot receive real-time delivery confirmation synchronously",{"type":48,"value":1377}," — Mail Send returns ",{"type":42,"tag":57,"props":1379,"children":1381},{"className":1380},[],[1382],{"type":48,"value":1383},"202",{"type":48,"value":1385}," (queued). Delivery status is async via webhooks only.",{"type":42,"tag":1368,"props":1387,"children":1388},{},[1389,1394],{"type":42,"tag":69,"props":1390,"children":1391},{},[1392],{"type":48,"value":1393},"Cannot rely on webhook authentication by default",{"type":48,"value":1395}," — Both Signed Webhooks (ECDSA) and OAuth 2.0 must be explicitly enabled. Without either, anyone can POST to your endpoint.",{"type":42,"tag":1368,"props":1397,"children":1398},{},[1399,1404],{"type":42,"tag":69,"props":1400,"children":1401},{},[1402],{"type":48,"value":1403},"Cannot guarantee open tracking accuracy",{"type":48,"value":1405}," — Apple Mail Privacy Protection and prefetch inflate opens. Image-blocking clients produce zero opens. Do not use for business-critical logic.",{"type":42,"tag":1368,"props":1407,"children":1408},{},[1409,1414],{"type":42,"tag":69,"props":1410,"children":1411},{},[1412],{"type":48,"value":1413},"Non-human interactions inflate engagement metrics",{"type":48,"value":1415}," — Corporate security scanners and bots automatically click links and trigger unsubscribe events. Filter using User-Agent patterns and timing analysis.",{"type":42,"tag":361,"props":1417,"children":1418},{},[1419],{"type":42,"tag":51,"props":1420,"children":1421},{},[1422,1427,1429,1434],{"type":42,"tag":69,"props":1423,"children":1424},{},[1425],{"type":48,"value":1426},"Note:",{"type":48,"value":1428}," Event payload fields like ",{"type":42,"tag":57,"props":1430,"children":1432},{"className":1431},[],[1433],{"type":48,"value":928},{"type":48,"value":1435}," originate from external mail servers and should be treated as untrusted data. Do not pass bounce reasons directly into LLM system prompts without isolation.",{"type":42,"tag":77,"props":1437,"children":1438},{},[],{"type":42,"tag":43,"props":1440,"children":1442},{"id":1441},"next-steps",[1443],{"type":48,"value":1444},"Next Steps",{"type":42,"tag":1364,"props":1446,"children":1447},{},[1448,1464,1479],{"type":42,"tag":1368,"props":1449,"children":1450},{},[1451,1456,1458],{"type":42,"tag":69,"props":1452,"children":1453},{},[1454],{"type":48,"value":1455},"Send email:",{"type":48,"value":1457}," ",{"type":42,"tag":57,"props":1459,"children":1461},{"className":1460},[],[1462],{"type":48,"value":1463},"twilio-sendgrid-email-send",{"type":42,"tag":1368,"props":1465,"children":1466},{},[1467,1472,1473],{"type":42,"tag":69,"props":1468,"children":1469},{},[1470],{"type":48,"value":1471},"Manage bounces from webhook events:",{"type":48,"value":1457},{"type":42,"tag":57,"props":1474,"children":1476},{"className":1475},[],[1477],{"type":48,"value":1478},"twilio-sendgrid-suppressions",{"type":42,"tag":1368,"props":1480,"children":1481},{},[1482,1487,1488],{"type":42,"tag":69,"props":1483,"children":1484},{},[1485],{"type":48,"value":1486},"Receive inbound email:",{"type":48,"value":1457},{"type":42,"tag":57,"props":1489,"children":1491},{"className":1490},[],[1492],{"type":48,"value":1493},"twilio-sendgrid-inbound-parse",{"type":42,"tag":1495,"props":1496,"children":1497},"style",{},[1498],{"type":48,"value":1499},"html .light .shiki span {color: var(--shiki-light);background: var(--shiki-light-bg);font-style: var(--shiki-light-font-style);font-weight: var(--shiki-light-font-weight);text-decoration: var(--shiki-light-text-decoration);}html.light .shiki span {color: var(--shiki-light);background: var(--shiki-light-bg);font-style: var(--shiki-light-font-style);font-weight: var(--shiki-light-font-weight);text-decoration: var(--shiki-light-text-decoration);}html .default .shiki span {color: var(--shiki-default);background: var(--shiki-default-bg);font-style: var(--shiki-default-font-style);font-weight: var(--shiki-default-font-weight);text-decoration: var(--shiki-default-text-decoration);}html .shiki span {color: var(--shiki-default);background: var(--shiki-default-bg);font-style: var(--shiki-default-font-style);font-weight: var(--shiki-default-font-weight);text-decoration: var(--shiki-default-text-decoration);}html .dark .shiki span {color: var(--shiki-dark);background: var(--shiki-dark-bg);font-style: var(--shiki-dark-font-style);font-weight: var(--shiki-dark-font-weight);text-decoration: var(--shiki-dark-text-decoration);}html.dark .shiki span {color: var(--shiki-dark);background: var(--shiki-dark-bg);font-style: var(--shiki-dark-font-style);font-weight: var(--shiki-dark-font-weight);text-decoration: var(--shiki-dark-text-decoration);}",{"items":1501,"total":1704},[1502,1523,1546,1563,1577,1596,1615,1631,1647,1661,1673,1688],{"slug":1503,"name":1503,"fn":1504,"description":1505,"org":1506,"tags":1507,"stars":1520,"repoUrl":1521,"updatedAt":1522},"prior-auth-packet-builder","build healthcare prior authorization packets","Build a concise prior authorization packet from local case files and payer policy docs.",{"slug":8,"name":9,"logoUrl":10,"githubOrg":8},[1508,1511,1514,1517],{"name":1509,"slug":1510,"type":15},"Documents","documents",{"name":1512,"slug":1513,"type":15},"Healthcare","healthcare",{"name":1515,"slug":1516,"type":15},"Insurance","insurance",{"name":1518,"slug":1519,"type":15},"Regulatory Compliance","regulatory-compliance",28169,"https:\u002F\u002Fgithub.com\u002Fopenai\u002Fopenai-agents-python","2026-04-16T05:11:39.180399",{"slug":1524,"name":1524,"fn":1525,"description":1526,"org":1527,"tags":1528,"stars":1543,"repoUrl":1544,"updatedAt":1545},"aspnet-core","build ASP.NET Core web applications","Build, review, refactor, or architect ASP.NET Core web applications using current official guidance for .NET web development. Use when working on Blazor Web Apps, Razor Pages, MVC, Minimal APIs, controller-based Web APIs, SignalR, gRPC, middleware, dependency injection, configuration, authentication, authorization, testing, performance, deployment, or ASP.NET Core upgrades.",{"slug":8,"name":9,"logoUrl":10,"githubOrg":8},[1529,1532,1534,1537,1540],{"name":1530,"slug":1531,"type":15},".NET","dotnet",{"name":1533,"slug":1524,"type":15},"ASP.NET Core",{"name":1535,"slug":1536,"type":15},"Blazor","blazor",{"name":1538,"slug":1539,"type":15},"C#","csharp",{"name":1541,"slug":1542,"type":15},"Web Development","web-development",23787,"https:\u002F\u002Fgithub.com\u002Fopenai\u002Fskills","2026-04-12T05:07:02.819491",{"slug":1547,"name":1547,"fn":1548,"description":1549,"org":1550,"tags":1551,"stars":1543,"repoUrl":1544,"updatedAt":1562},"chatgpt-apps","build ChatGPT Apps SDK applications","Build, scaffold, refactor, and troubleshoot ChatGPT Apps SDK applications that combine an MCP server and widget UI. Use when Codex needs to design tools, register UI resources, wire the MCP Apps bridge or ChatGPT compatibility APIs, apply Apps SDK metadata or CSP or domain settings, or produce a docs-aligned project scaffold. Prefer a docs-first workflow by invoking the openai-docs skill or OpenAI developer docs MCP tools before generating code.",{"slug":8,"name":9,"logoUrl":10,"githubOrg":8},[1552,1555,1558,1561],{"name":1553,"slug":1554,"type":15},"Apps SDK","apps-sdk",{"name":1556,"slug":1557,"type":15},"ChatGPT","chatgpt",{"name":1559,"slug":1560,"type":15},"MCP","mcp",{"name":9,"slug":8,"type":15},"2026-04-12T05:07:05.468097",{"slug":1564,"name":1564,"fn":1565,"description":1566,"org":1567,"tags":1568,"stars":1543,"repoUrl":1544,"updatedAt":1576},"cli-creator","build CLIs from API docs","Build a composable CLI for Codex from API docs, an OpenAPI spec, existing curl examples, an SDK, a web app, an admin tool, or a local script. Use when the user wants Codex to create a command-line tool that can run from any repo, expose composable read\u002Fwrite commands, return stable JSON, manage auth, and pair with a companion skill.",{"slug":8,"name":9,"logoUrl":10,"githubOrg":8},[1569,1570,1573],{"name":17,"slug":18,"type":15},{"name":1571,"slug":1572,"type":15},"CLI","cli",{"name":1574,"slug":1575,"type":15},"Codex","codex","2026-04-12T05:07:04.132762",{"slug":1578,"name":1578,"fn":1579,"description":1580,"org":1581,"tags":1582,"stars":1543,"repoUrl":1544,"updatedAt":1595},"cloudflare-deploy","deploy projects to Cloudflare","Deploy applications and infrastructure to Cloudflare using Workers, Pages, and related platform services. Use when the user asks to deploy, host, publish, or set up a project on Cloudflare.",{"slug":8,"name":9,"logoUrl":10,"githubOrg":8},[1583,1586,1589,1592],{"name":1584,"slug":1585,"type":15},"Cloudflare","cloudflare",{"name":1587,"slug":1588,"type":15},"Cloudflare Pages","cloudflare-pages",{"name":1590,"slug":1591,"type":15},"Cloudflare Workers","cloudflare-workers",{"name":1593,"slug":1594,"type":15},"Deployment","deployment","2026-04-12T05:07:14.275118",{"slug":1597,"name":1597,"fn":1598,"description":1599,"org":1600,"tags":1601,"stars":1543,"repoUrl":1544,"updatedAt":1614},"define-goal","define and set measurable project goals","Help the user define a concrete, measurable goal before starting work, especially when they ask to use the goal tool, create a goal, set an objective, clarify success criteria, or turn a fuzzy intention into a quantitative outcome. Use this skill for goal creation and goal refinement only; it does not manage durable snapshots, decision logs, or long-running execution artifacts.",{"slug":8,"name":9,"logoUrl":10,"githubOrg":8},[1602,1605,1608,1611],{"name":1603,"slug":1604,"type":15},"Productivity","productivity",{"name":1606,"slug":1607,"type":15},"Project Management","project-management",{"name":1609,"slug":1610,"type":15},"Strategy","strategy",{"name":1612,"slug":1613,"type":15},"Task Management","task-management","2026-05-23T06:17:16.870838",{"slug":1616,"name":1616,"fn":1617,"description":1618,"org":1619,"tags":1620,"stars":1543,"repoUrl":1544,"updatedAt":1630},"figma","translate Figma designs into code","Use the Figma MCP server to fetch design context, screenshots, variables, and assets from Figma, and to translate Figma nodes into production code. Trigger when a task involves Figma URLs, node IDs, design-to-code implementation, or Figma MCP setup and troubleshooting.",{"slug":8,"name":9,"logoUrl":10,"githubOrg":8},[1621,1624,1626,1629],{"name":1622,"slug":1623,"type":15},"Design","design",{"name":1625,"slug":1616,"type":15},"Figma",{"name":1627,"slug":1628,"type":15},"Frontend","frontend",{"name":1559,"slug":1560,"type":15},"2026-04-12T05:06:47.939943",{"slug":1632,"name":1632,"fn":1633,"description":1634,"org":1635,"tags":1636,"stars":1543,"repoUrl":1544,"updatedAt":1646},"figma-code-connect-components","connect Figma designs to code components","Connects Figma design components to code components using Code Connect mapping tools. Use when user says \"code connect\", \"connect this component to code\", \"map this component\", \"link component to code\", \"create code connect mapping\", or wants to establish mappings between Figma designs and code implementations. For canvas writes via `use_figma`, use `figma-use`.",{"slug":8,"name":9,"logoUrl":10,"githubOrg":8},[1637,1638,1641,1642,1643],{"name":1622,"slug":1623,"type":15},{"name":1639,"slug":1640,"type":15},"Design System","design-system",{"name":1625,"slug":1616,"type":15},{"name":1627,"slug":1628,"type":15},{"name":1644,"slug":1645,"type":15},"UI Components","ui-components","2026-05-10T05:59:52.971881",{"slug":1648,"name":1648,"fn":1649,"description":1650,"org":1651,"tags":1652,"stars":1543,"repoUrl":1544,"updatedAt":1660},"figma-create-design-system-rules","generate design system rules from Figma","Generates custom design system rules for the user's codebase. Use when user says \"create design system rules\", \"generate rules for my project\", \"set up design rules\", \"customize design system guidelines\", or wants to establish project-specific conventions for Figma-to-code workflows. Requires Figma MCP server connection.",{"slug":8,"name":9,"logoUrl":10,"githubOrg":8},[1653,1654,1655,1658,1659],{"name":1622,"slug":1623,"type":15},{"name":1639,"slug":1640,"type":15},{"name":1656,"slug":1657,"type":15},"Documentation","documentation",{"name":1625,"slug":1616,"type":15},{"name":1627,"slug":1628,"type":15},"2026-05-16T06:07:47.821474",{"slug":1662,"name":1662,"fn":1663,"description":1664,"org":1665,"tags":1666,"stars":1543,"repoUrl":1544,"updatedAt":1672},"figma-implement-design","translate Figma designs into application code","Translates Figma designs into production-ready application code with 1:1 visual fidelity. Use when implementing UI code from Figma files, when user mentions \"implement design\", \"generate code\", \"implement component\", provides Figma URLs, or asks to build components matching Figma specs. For Figma canvas writes via `use_figma`, use `figma-use`.",{"slug":8,"name":9,"logoUrl":10,"githubOrg":8},[1667,1668,1669,1670,1671],{"name":1622,"slug":1623,"type":15},{"name":1625,"slug":1616,"type":15},{"name":1627,"slug":1628,"type":15},{"name":1644,"slug":1645,"type":15},{"name":1541,"slug":1542,"type":15},"2026-05-16T06:07:40.583615",{"slug":1674,"name":1674,"fn":1675,"description":1676,"org":1677,"tags":1678,"stars":1543,"repoUrl":1544,"updatedAt":1687},"hatch-pet","create animated pets for Codex","Create, repair, validate, visually QA, and package Codex-compatible animated pets and pet spritesheets from character art, generated images, company or prospect brand cues, or visual references. Use when a user wants a lightweight-worker Codex pet workflow, a non-pixel custom pet style, a prospect or company mascot pet, or a full 8x9 animated pet atlas with transparent unused cells, QA contact sheets, and pet.json packaging. This skill composes the installed $imagegen system skill for visual generation and uses bundled scripts for deterministic spritesheet assembly.",{"slug":8,"name":9,"logoUrl":10,"githubOrg":8},[1679,1682,1683,1686],{"name":1680,"slug":1681,"type":15},"Animation","animation",{"name":1574,"slug":1575,"type":15},{"name":1684,"slug":1685,"type":15},"Creative","creative",{"name":1622,"slug":1623,"type":15},"2026-05-02T05:31:48.48485",{"slug":1689,"name":1689,"fn":1690,"description":1691,"org":1692,"tags":1693,"stars":1543,"repoUrl":1544,"updatedAt":1703},"imagegen","generate and edit raster images","Generate or edit raster images when the task benefits from AI-created bitmap visuals such as photos, illustrations, textures, sprites, mockups, or transparent-background cutouts. Use when Codex should create a brand-new image, transform an existing image, or derive visual variants from references, and the output should be a bitmap asset rather than repo-native code or vector. Do not use when the task is better handled by editing existing SVG\u002Fvector\u002Fcode-native assets, extending an established icon or logo system, or building the visual directly in HTML\u002FCSS\u002Fcanvas.",{"slug":8,"name":9,"logoUrl":10,"githubOrg":8},[1694,1695,1696,1699,1702],{"name":1684,"slug":1685,"type":15},{"name":1622,"slug":1623,"type":15},{"name":1697,"slug":1698,"type":15},"Image Generation","image-generation",{"name":1700,"slug":1701,"type":15},"Images","images",{"name":9,"slug":8,"type":15},"2026-05-15T06:23:24.312127",675,{"items":1706,"total":1819},[1707,1723,1739,1751,1769,1787,1807],{"slug":1708,"name":1708,"fn":1709,"description":1710,"org":1711,"tags":1712,"stars":25,"repoUrl":26,"updatedAt":27},"accessibility-and-inclusive-visualization","make data visualizations accessible","Make data visualizations accessible and inclusive. Use when the user needs chart or diagram accessibility guidance, text alternatives for complex visuals, color and contrast review, keyboard support, reduced-motion behavior for animation or parallax, or an accessibility QA workflow for exported figures, UML-like diagrams, and dashboards.",{"slug":8,"name":9,"logoUrl":10,"githubOrg":8},[1713,1716,1719,1722],{"name":1714,"slug":1715,"type":15},"Accessibility","accessibility",{"name":1717,"slug":1718,"type":15},"Charts","charts",{"name":1720,"slug":1721,"type":15},"Data Visualization","data-visualization",{"name":1622,"slug":1623,"type":15},{"slug":1724,"name":1724,"fn":1725,"description":1726,"org":1727,"tags":1728,"stars":25,"repoUrl":26,"updatedAt":1738},"agent-browser","automate browser interactions for agents","Browser automation CLI for AI agents. Use when the user needs to interact with websites, verify dev server output, test web apps, navigate pages, fill forms, click buttons, take screenshots, extract data, or automate any browser task. Also triggers when a dev server starts so you can verify it visually.",{"slug":8,"name":9,"logoUrl":10,"githubOrg":8},[1729,1732,1735],{"name":1730,"slug":1731,"type":15},"Agents","agents",{"name":1733,"slug":1734,"type":15},"Browser Automation","browser-automation",{"name":1736,"slug":1737,"type":15},"Testing","testing","2026-04-06T18:41:03.44016",{"slug":1740,"name":1740,"fn":1741,"description":1742,"org":1743,"tags":1744,"stars":25,"repoUrl":26,"updatedAt":1750},"agent-browser-verify","verify dev server output with automated browser","Automated browser verification for dev servers. Triggers when a dev server starts to run a visual gut-check with agent-browser — verifies the page loads, checks for console errors, validates key UI elements, and reports pass\u002Ffail before continuing.",{"slug":8,"name":9,"logoUrl":10,"githubOrg":8},[1745,1746,1749],{"name":1733,"slug":1734,"type":15},{"name":1747,"slug":1748,"type":15},"Local Development","local-development",{"name":1736,"slug":1737,"type":15},"2026-04-06T18:41:17.526867",{"slug":1752,"name":1752,"fn":1753,"description":1754,"org":1755,"tags":1756,"stars":25,"repoUrl":26,"updatedAt":1768},"agents-sdk","build AI agents on Cloudflare Workers","Build AI agents on Cloudflare Workers using the Agents SDK. Load when creating stateful agents, durable workflows, real-time WebSocket apps, scheduled tasks, MCP servers, or chat applications. Covers Agent class, state management, callable RPC, Workflows integration, and React hooks. Biases towards retrieval from Cloudflare docs over pre-trained knowledge.",{"slug":8,"name":9,"logoUrl":10,"githubOrg":8},[1757,1758,1759,1762,1765],{"name":1730,"slug":1731,"type":15},{"name":1590,"slug":1591,"type":15},{"name":1760,"slug":1761,"type":15},"SDK","sdk",{"name":1763,"slug":1764,"type":15},"Serverless","serverless",{"name":1766,"slug":1767,"type":15},"WebSockets","websockets","2026-04-06T18:39:51.717063",{"slug":1770,"name":1770,"fn":1771,"description":1772,"org":1773,"tags":1774,"stars":25,"repoUrl":26,"updatedAt":1786},"ai-elements","build chat UIs with AI Elements","AI Elements component library guidance — pre-built React components for AI interfaces built on shadcn\u002Fui. Use when building chat UIs, message displays, tool call rendering, streaming responses, reasoning panels, or any AI-native interface with the AI SDK.",{"slug":8,"name":9,"logoUrl":10,"githubOrg":8},[1775,1776,1779,1782,1783],{"name":1627,"slug":1628,"type":15},{"name":1777,"slug":1778,"type":15},"React","react",{"name":1780,"slug":1781,"type":15},"shadcn\u002Fui","shadcn-ui",{"name":1644,"slug":1645,"type":15},{"name":1784,"slug":1785,"type":15},"Vercel","vercel","2026-04-06T18:40:59.619419",{"slug":1788,"name":1788,"fn":1789,"description":1790,"org":1791,"tags":1792,"stars":25,"repoUrl":26,"updatedAt":1806},"ai-gateway","configure Vercel AI Gateway","Vercel AI Gateway expert guidance. Use when configuring model routing, provider failover, cost tracking, or managing multiple AI providers through a unified API.",{"slug":8,"name":9,"logoUrl":10,"githubOrg":8},[1793,1796,1799,1802,1805],{"name":1794,"slug":1795,"type":15},"AI Infrastructure","ai-infrastructure",{"name":1797,"slug":1798,"type":15},"Cost Optimization","cost-optimization",{"name":1800,"slug":1801,"type":15},"LLM","llm",{"name":1803,"slug":1804,"type":15},"Performance","performance",{"name":1784,"slug":1785,"type":15},"2026-04-06T18:40:44.377464",{"slug":1808,"name":1808,"fn":1809,"description":1810,"org":1811,"tags":1812,"stars":25,"repoUrl":26,"updatedAt":1818},"ai-generation-persistence","implement persistence patterns for AI generations","AI generation persistence patterns — unique IDs, addressable URLs, database storage, and cost tracking for every LLM generation",{"slug":8,"name":9,"logoUrl":10,"githubOrg":8},[1813,1814,1817],{"name":1797,"slug":1798,"type":15},{"name":1815,"slug":1816,"type":15},"Database","database",{"name":1800,"slug":1801,"type":15},"2026-04-06T18:41:08.513425",600]