[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"skill-twilio-twilio-sendgrid-suppressions":3,"mdc-xtcffd-key":33,"related-org-twilio-twilio-sendgrid-suppressions":701,"related-repo-twilio-twilio-sendgrid-suppressions":882},{"slug":4,"name":4,"fn":5,"description":6,"org":7,"tags":11,"stars":23,"repoUrl":24,"updatedAt":25,"license":26,"forks":27,"topics":28,"repo":29,"sourceUrl":31,"mdContent":32},"twilio-sendgrid-suppressions","manage SendGrid email suppressions","Manage SendGrid email suppressions: bounces, blocks, spam reports, invalid emails, global unsubscribes, and ASM suppression groups. Covers when and how to remove suppressions, reputation impact, and category-based unsubscribe management. Use when debugging SendGrid delivery issues or building unsubscribe flows. 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},"twilio","Twilio","https:\u002F\u002Fpexgzepcugksgbtrxkhf.supabase.co\u002Fstorage\u002Fv1\u002Fobject\u002Fpublic\u002Forg-logos\u002Ftwilio.png",[12,16,19,22],{"name":13,"slug":14,"type":15},"Compliance","compliance","tag",{"name":17,"slug":18,"type":15},"SendGrid","sendgrid",{"name":20,"slug":21,"type":15},"Email","email",{"name":9,"slug":8,"type":15},25,"https:\u002F\u002Fgithub.com\u002Ftwilio\u002Fai","2026-07-17T06:07:19.785536",null,7,[],{"repoUrl":24,"stars":23,"forks":27,"topics":30,"description":26},[],"https:\u002F\u002Fgithub.com\u002Ftwilio\u002Fai\u002Ftree\u002FHEAD\u002Fskills\u002Fsendgrid\u002Ftwilio-sendgrid-suppressions","---\nname: twilio-sendgrid-suppressions\ndescription: >\n  Manage SendGrid email suppressions: bounces, blocks, spam reports,\n  invalid emails, global unsubscribes, and ASM suppression groups.\n  Covers when and how to remove suppressions, reputation impact, and\n  category-based unsubscribe management. Use when debugging SendGrid\n  delivery issues or building unsubscribe flows. Requires a SendGrid API\n  key (SG.-prefix) — not applicable to the Twilio Email API (comms.twilio.com).\n---\n\n## Overview\n\nSuppressions prevent SendGrid from sending to addresses that have bounced, reported spam, or unsubscribed. They protect your sender reputation but can also block legitimate re-sends if not managed correctly.\n\n---\n\n## Suppression Types\n\n| Type | Endpoint | What triggers it | Auto-added? |\n|------|----------|-----------------|-------------|\n| **Hard Bounces** | `\u002Fv3\u002Fsuppression\u002Fbounces` | Permanent delivery failure (invalid mailbox, domain doesn't exist) | Yes |\n| **Soft Bounces** | No management API — automatic retry only | Temporary failure (mailbox full, server down) — SendGrid auto-retries before suppressing | Yes, after repeated failures |\n| **Blocks** | `\u002Fv3\u002Fsuppression\u002Fblocks` | Temporary rejection by receiving server (reputation, policy, content) | Yes |\n| **Spam Reports** | `\u002Fv3\u002Fsuppression\u002Fspam_reports` | Recipient marks email as spam | Yes |\n| **Invalid Emails** | `\u002Fv3\u002Fsuppression\u002Finvalid_emails` | Malformed email address | Yes |\n| **Global Unsubscribes** | `\u002Fv3\u002Fsuppression\u002Funsubscribes` | Recipient unsubscribes from all email | Yes |\n| **Group Unsubscribes (ASM)** | `\u002Fv3\u002Fasm\u002Fgroups\u002F{id}\u002Fsuppressions` | Recipient unsubscribes from a category | Yes |\n\n**Hard vs Soft bounces:** Hard bounces (permanent) immediately suppress the address. Soft bounces (temporary) trigger retries — SendGrid will retry delivery before eventually suppressing if the issue persists.\n\n---\n\n## Managing Suppressions\n\n**List bounces (Python)**\n```python\nimport os, requests\n\nheaders = {\"Authorization\": f\"Bearer {os.environ['SENDGRID_API_KEY']}\"}\nresponse = requests.get(\"https:\u002F\u002Fapi.sendgrid.com\u002Fv3\u002Fsuppression\u002Fbounces\", headers=headers)\nfor bounce in response.json():\n    print(f\"{bounce['email']}: {bounce.get('reason', 'unknown')}\")\n```\n\n**Remove a bounce (Python)**\n```python\nrequests.delete(f\"https:\u002F\u002Fapi.sendgrid.com\u002Fv3\u002Fsuppression\u002Fbounces\u002F{email}\", headers=headers)\n```\n\n> **Caution:** Deleting suppression records (especially spam reports) allows re-sending to addresses that previously complained. Always confirm with the user before removal and document the business reason.\n\n---\n\n## ASM Suppression Groups\n\nUse suppression groups for category-based unsubscribes (e.g., \"Marketing\", \"Transactional\", \"Product Updates\"). Recipients can unsubscribe from one category without being suppressed from all email.\n\n**Create a group:**\n```python\nrequests.post(\"https:\u002F\u002Fapi.sendgrid.com\u002Fv3\u002Fasm\u002Fgroups\",\n    headers={**headers, \"Content-Type\": \"application\u002Fjson\"},\n    json={\"name\": \"Marketing Emails\", \"description\": \"Promotional offers and updates\"})\n```\n\n**Send with a suppression group:**\nInclude `asm.group_id` in your Mail Send request. Recipients see a \"manage preferences\" link instead of a global unsubscribe.\n\n---\n\n## Auto-Purge (Bounce & Block Cleanup)\n\nConfigure automatic purge schedules in Console > Settings > Mail Settings > Purge Bounces & Blocks:\n\n- **Soft Bounces:** Auto-purge after N days (1–3,650 days)\n- **Hard Bounces:** Auto-purge after N days (1–3,650 days)\n\n**Caution:** Enabling auto-purge without a business reason allows re-sending to previously bounced addresses, which damages sender reputation. Do not use as a workaround to force delivery.\n\n---\n\n## Address Allow List\n\nConsole > Settings > Mail Settings > Address Allow List allows specific email addresses or domains to bypass all suppressions. Useful for internal testing addresses.\n\n**Use with extreme caution** — never allowlist domains you don't control (e.g., `gmail.com`), and never use to bypass spam report suppressions.\n\n---\n\n## CANNOT\n\n- **Suppressions are global by default** — A bounce or spam report on ANY email suppresses the address from ALL future sends. Use ASM groups to scope unsubscribes.\n- **Removing a suppression does not fix the underlying issue** — Deleting a bounce record lets you retry, but the mailbox is likely still invalid. Re-sending to hard bounces damages sender reputation.\n- **Cannot prevent spam report suppressions** — When a recipient marks you as spam, the suppression is automatic and cannot be overridden.\n- **Cannot bulk-remove suppressions by domain** — Must remove individually by email address via API.\n\n---\n\n## Next Steps\n\n- **Send email:** `twilio-sendgrid-email-send`\n- **Delivery tracking:** `twilio-sendgrid-webhooks`\n- **Account setup:** `twilio-sendgrid-account-setup`\n",{"data":34,"body":35},{"name":4,"description":6},{"type":36,"children":37},"root",[38,47,53,57,63,304,314,317,323,331,399,407,421,435,438,444,449,457,488,506,509,515,520,544,553,556,562,567,585,588,594,637,640,646,695],{"type":39,"tag":40,"props":41,"children":43},"element","h2",{"id":42},"overview",[44],{"type":45,"value":46},"text","Overview",{"type":39,"tag":48,"props":49,"children":50},"p",{},[51],{"type":45,"value":52},"Suppressions prevent SendGrid from sending to addresses that have bounced, reported spam, or unsubscribed. They protect your sender reputation but can also block legitimate re-sends if not managed correctly.",{"type":39,"tag":54,"props":55,"children":56},"hr",{},[],{"type":39,"tag":40,"props":58,"children":60},{"id":59},"suppression-types",[61],{"type":45,"value":62},"Suppression Types",{"type":39,"tag":64,"props":65,"children":66},"table",{},[67,96],{"type":39,"tag":68,"props":69,"children":70},"thead",{},[71],{"type":39,"tag":72,"props":73,"children":74},"tr",{},[75,81,86,91],{"type":39,"tag":76,"props":77,"children":78},"th",{},[79],{"type":45,"value":80},"Type",{"type":39,"tag":76,"props":82,"children":83},{},[84],{"type":45,"value":85},"Endpoint",{"type":39,"tag":76,"props":87,"children":88},{},[89],{"type":45,"value":90},"What triggers it",{"type":39,"tag":76,"props":92,"children":93},{},[94],{"type":45,"value":95},"Auto-added?",{"type":39,"tag":97,"props":98,"children":99},"tbody",{},[100,133,159,188,217,246,275],{"type":39,"tag":72,"props":101,"children":102},{},[103,113,123,128],{"type":39,"tag":104,"props":105,"children":106},"td",{},[107],{"type":39,"tag":108,"props":109,"children":110},"strong",{},[111],{"type":45,"value":112},"Hard Bounces",{"type":39,"tag":104,"props":114,"children":115},{},[116],{"type":39,"tag":117,"props":118,"children":120},"code",{"className":119},[],[121],{"type":45,"value":122},"\u002Fv3\u002Fsuppression\u002Fbounces",{"type":39,"tag":104,"props":124,"children":125},{},[126],{"type":45,"value":127},"Permanent delivery failure (invalid mailbox, domain doesn't exist)",{"type":39,"tag":104,"props":129,"children":130},{},[131],{"type":45,"value":132},"Yes",{"type":39,"tag":72,"props":134,"children":135},{},[136,144,149,154],{"type":39,"tag":104,"props":137,"children":138},{},[139],{"type":39,"tag":108,"props":140,"children":141},{},[142],{"type":45,"value":143},"Soft Bounces",{"type":39,"tag":104,"props":145,"children":146},{},[147],{"type":45,"value":148},"No management API — automatic retry only",{"type":39,"tag":104,"props":150,"children":151},{},[152],{"type":45,"value":153},"Temporary failure (mailbox full, server down) — SendGrid auto-retries before suppressing",{"type":39,"tag":104,"props":155,"children":156},{},[157],{"type":45,"value":158},"Yes, after repeated failures",{"type":39,"tag":72,"props":160,"children":161},{},[162,170,179,184],{"type":39,"tag":104,"props":163,"children":164},{},[165],{"type":39,"tag":108,"props":166,"children":167},{},[168],{"type":45,"value":169},"Blocks",{"type":39,"tag":104,"props":171,"children":172},{},[173],{"type":39,"tag":117,"props":174,"children":176},{"className":175},[],[177],{"type":45,"value":178},"\u002Fv3\u002Fsuppression\u002Fblocks",{"type":39,"tag":104,"props":180,"children":181},{},[182],{"type":45,"value":183},"Temporary rejection by receiving server (reputation, policy, content)",{"type":39,"tag":104,"props":185,"children":186},{},[187],{"type":45,"value":132},{"type":39,"tag":72,"props":189,"children":190},{},[191,199,208,213],{"type":39,"tag":104,"props":192,"children":193},{},[194],{"type":39,"tag":108,"props":195,"children":196},{},[197],{"type":45,"value":198},"Spam Reports",{"type":39,"tag":104,"props":200,"children":201},{},[202],{"type":39,"tag":117,"props":203,"children":205},{"className":204},[],[206],{"type":45,"value":207},"\u002Fv3\u002Fsuppression\u002Fspam_reports",{"type":39,"tag":104,"props":209,"children":210},{},[211],{"type":45,"value":212},"Recipient marks email as spam",{"type":39,"tag":104,"props":214,"children":215},{},[216],{"type":45,"value":132},{"type":39,"tag":72,"props":218,"children":219},{},[220,228,237,242],{"type":39,"tag":104,"props":221,"children":222},{},[223],{"type":39,"tag":108,"props":224,"children":225},{},[226],{"type":45,"value":227},"Invalid Emails",{"type":39,"tag":104,"props":229,"children":230},{},[231],{"type":39,"tag":117,"props":232,"children":234},{"className":233},[],[235],{"type":45,"value":236},"\u002Fv3\u002Fsuppression\u002Finvalid_emails",{"type":39,"tag":104,"props":238,"children":239},{},[240],{"type":45,"value":241},"Malformed email address",{"type":39,"tag":104,"props":243,"children":244},{},[245],{"type":45,"value":132},{"type":39,"tag":72,"props":247,"children":248},{},[249,257,266,271],{"type":39,"tag":104,"props":250,"children":251},{},[252],{"type":39,"tag":108,"props":253,"children":254},{},[255],{"type":45,"value":256},"Global Unsubscribes",{"type":39,"tag":104,"props":258,"children":259},{},[260],{"type":39,"tag":117,"props":261,"children":263},{"className":262},[],[264],{"type":45,"value":265},"\u002Fv3\u002Fsuppression\u002Funsubscribes",{"type":39,"tag":104,"props":267,"children":268},{},[269],{"type":45,"value":270},"Recipient unsubscribes from all email",{"type":39,"tag":104,"props":272,"children":273},{},[274],{"type":45,"value":132},{"type":39,"tag":72,"props":276,"children":277},{},[278,286,295,300],{"type":39,"tag":104,"props":279,"children":280},{},[281],{"type":39,"tag":108,"props":282,"children":283},{},[284],{"type":45,"value":285},"Group Unsubscribes (ASM)",{"type":39,"tag":104,"props":287,"children":288},{},[289],{"type":39,"tag":117,"props":290,"children":292},{"className":291},[],[293],{"type":45,"value":294},"\u002Fv3\u002Fasm\u002Fgroups\u002F{id}\u002Fsuppressions",{"type":39,"tag":104,"props":296,"children":297},{},[298],{"type":45,"value":299},"Recipient unsubscribes from a category",{"type":39,"tag":104,"props":301,"children":302},{},[303],{"type":45,"value":132},{"type":39,"tag":48,"props":305,"children":306},{},[307,312],{"type":39,"tag":108,"props":308,"children":309},{},[310],{"type":45,"value":311},"Hard vs Soft bounces:",{"type":45,"value":313}," Hard bounces (permanent) immediately suppress the address. Soft bounces (temporary) trigger retries — SendGrid will retry delivery before eventually suppressing if the issue persists.",{"type":39,"tag":54,"props":315,"children":316},{},[],{"type":39,"tag":40,"props":318,"children":320},{"id":319},"managing-suppressions",[321],{"type":45,"value":322},"Managing Suppressions",{"type":39,"tag":48,"props":324,"children":325},{},[326],{"type":39,"tag":108,"props":327,"children":328},{},[329],{"type":45,"value":330},"List bounces (Python)",{"type":39,"tag":332,"props":333,"children":338},"pre",{"className":334,"code":335,"language":336,"meta":337,"style":337},"language-python shiki shiki-themes material-theme-lighter material-theme material-theme-palenight","import os, requests\n\nheaders = {\"Authorization\": f\"Bearer {os.environ['SENDGRID_API_KEY']}\"}\nresponse = requests.get(\"https:\u002F\u002Fapi.sendgrid.com\u002Fv3\u002Fsuppression\u002Fbounces\", headers=headers)\nfor bounce in response.json():\n    print(f\"{bounce['email']}: {bounce.get('reason', 'unknown')}\")\n","python","",[339],{"type":39,"tag":117,"props":340,"children":341},{"__ignoreMap":337},[342,353,363,372,381,390],{"type":39,"tag":343,"props":344,"children":347},"span",{"class":345,"line":346},"line",1,[348],{"type":39,"tag":343,"props":349,"children":350},{},[351],{"type":45,"value":352},"import os, requests\n",{"type":39,"tag":343,"props":354,"children":356},{"class":345,"line":355},2,[357],{"type":39,"tag":343,"props":358,"children":360},{"emptyLinePlaceholder":359},true,[361],{"type":45,"value":362},"\n",{"type":39,"tag":343,"props":364,"children":366},{"class":345,"line":365},3,[367],{"type":39,"tag":343,"props":368,"children":369},{},[370],{"type":45,"value":371},"headers = {\"Authorization\": f\"Bearer {os.environ['SENDGRID_API_KEY']}\"}\n",{"type":39,"tag":343,"props":373,"children":375},{"class":345,"line":374},4,[376],{"type":39,"tag":343,"props":377,"children":378},{},[379],{"type":45,"value":380},"response = requests.get(\"https:\u002F\u002Fapi.sendgrid.com\u002Fv3\u002Fsuppression\u002Fbounces\", headers=headers)\n",{"type":39,"tag":343,"props":382,"children":384},{"class":345,"line":383},5,[385],{"type":39,"tag":343,"props":386,"children":387},{},[388],{"type":45,"value":389},"for bounce in response.json():\n",{"type":39,"tag":343,"props":391,"children":393},{"class":345,"line":392},6,[394],{"type":39,"tag":343,"props":395,"children":396},{},[397],{"type":45,"value":398},"    print(f\"{bounce['email']}: {bounce.get('reason', 'unknown')}\")\n",{"type":39,"tag":48,"props":400,"children":401},{},[402],{"type":39,"tag":108,"props":403,"children":404},{},[405],{"type":45,"value":406},"Remove a bounce (Python)",{"type":39,"tag":332,"props":408,"children":410},{"className":334,"code":409,"language":336,"meta":337,"style":337},"requests.delete(f\"https:\u002F\u002Fapi.sendgrid.com\u002Fv3\u002Fsuppression\u002Fbounces\u002F{email}\", headers=headers)\n",[411],{"type":39,"tag":117,"props":412,"children":413},{"__ignoreMap":337},[414],{"type":39,"tag":343,"props":415,"children":416},{"class":345,"line":346},[417],{"type":39,"tag":343,"props":418,"children":419},{},[420],{"type":45,"value":409},{"type":39,"tag":422,"props":423,"children":424},"blockquote",{},[425],{"type":39,"tag":48,"props":426,"children":427},{},[428,433],{"type":39,"tag":108,"props":429,"children":430},{},[431],{"type":45,"value":432},"Caution:",{"type":45,"value":434}," Deleting suppression records (especially spam reports) allows re-sending to addresses that previously complained. Always confirm with the user before removal and document the business reason.",{"type":39,"tag":54,"props":436,"children":437},{},[],{"type":39,"tag":40,"props":439,"children":441},{"id":440},"asm-suppression-groups",[442],{"type":45,"value":443},"ASM Suppression Groups",{"type":39,"tag":48,"props":445,"children":446},{},[447],{"type":45,"value":448},"Use suppression groups for category-based unsubscribes (e.g., \"Marketing\", \"Transactional\", \"Product Updates\"). Recipients can unsubscribe from one category without being suppressed from all email.",{"type":39,"tag":48,"props":450,"children":451},{},[452],{"type":39,"tag":108,"props":453,"children":454},{},[455],{"type":45,"value":456},"Create a group:",{"type":39,"tag":332,"props":458,"children":460},{"className":334,"code":459,"language":336,"meta":337,"style":337},"requests.post(\"https:\u002F\u002Fapi.sendgrid.com\u002Fv3\u002Fasm\u002Fgroups\",\n    headers={**headers, \"Content-Type\": \"application\u002Fjson\"},\n    json={\"name\": \"Marketing Emails\", \"description\": \"Promotional offers and updates\"})\n",[461],{"type":39,"tag":117,"props":462,"children":463},{"__ignoreMap":337},[464,472,480],{"type":39,"tag":343,"props":465,"children":466},{"class":345,"line":346},[467],{"type":39,"tag":343,"props":468,"children":469},{},[470],{"type":45,"value":471},"requests.post(\"https:\u002F\u002Fapi.sendgrid.com\u002Fv3\u002Fasm\u002Fgroups\",\n",{"type":39,"tag":343,"props":473,"children":474},{"class":345,"line":355},[475],{"type":39,"tag":343,"props":476,"children":477},{},[478],{"type":45,"value":479},"    headers={**headers, \"Content-Type\": \"application\u002Fjson\"},\n",{"type":39,"tag":343,"props":481,"children":482},{"class":345,"line":365},[483],{"type":39,"tag":343,"props":484,"children":485},{},[486],{"type":45,"value":487},"    json={\"name\": \"Marketing Emails\", \"description\": \"Promotional offers and updates\"})\n",{"type":39,"tag":48,"props":489,"children":490},{},[491,496,498,504],{"type":39,"tag":108,"props":492,"children":493},{},[494],{"type":45,"value":495},"Send with a suppression group:",{"type":45,"value":497},"\nInclude ",{"type":39,"tag":117,"props":499,"children":501},{"className":500},[],[502],{"type":45,"value":503},"asm.group_id",{"type":45,"value":505}," in your Mail Send request. Recipients see a \"manage preferences\" link instead of a global unsubscribe.",{"type":39,"tag":54,"props":507,"children":508},{},[],{"type":39,"tag":40,"props":510,"children":512},{"id":511},"auto-purge-bounce-block-cleanup",[513],{"type":45,"value":514},"Auto-Purge (Bounce & Block Cleanup)",{"type":39,"tag":48,"props":516,"children":517},{},[518],{"type":45,"value":519},"Configure automatic purge schedules in Console > Settings > Mail Settings > Purge Bounces & Blocks:",{"type":39,"tag":521,"props":522,"children":523},"ul",{},[524,535],{"type":39,"tag":525,"props":526,"children":527},"li",{},[528,533],{"type":39,"tag":108,"props":529,"children":530},{},[531],{"type":45,"value":532},"Soft Bounces:",{"type":45,"value":534}," Auto-purge after N days (1–3,650 days)",{"type":39,"tag":525,"props":536,"children":537},{},[538,543],{"type":39,"tag":108,"props":539,"children":540},{},[541],{"type":45,"value":542},"Hard Bounces:",{"type":45,"value":534},{"type":39,"tag":48,"props":545,"children":546},{},[547,551],{"type":39,"tag":108,"props":548,"children":549},{},[550],{"type":45,"value":432},{"type":45,"value":552}," Enabling auto-purge without a business reason allows re-sending to previously bounced addresses, which damages sender reputation. Do not use as a workaround to force delivery.",{"type":39,"tag":54,"props":554,"children":555},{},[],{"type":39,"tag":40,"props":557,"children":559},{"id":558},"address-allow-list",[560],{"type":45,"value":561},"Address Allow List",{"type":39,"tag":48,"props":563,"children":564},{},[565],{"type":45,"value":566},"Console > Settings > Mail Settings > Address Allow List allows specific email addresses or domains to bypass all suppressions. Useful for internal testing addresses.",{"type":39,"tag":48,"props":568,"children":569},{},[570,575,577,583],{"type":39,"tag":108,"props":571,"children":572},{},[573],{"type":45,"value":574},"Use with extreme caution",{"type":45,"value":576}," — never allowlist domains you don't control (e.g., ",{"type":39,"tag":117,"props":578,"children":580},{"className":579},[],[581],{"type":45,"value":582},"gmail.com",{"type":45,"value":584},"), and never use to bypass spam report suppressions.",{"type":39,"tag":54,"props":586,"children":587},{},[],{"type":39,"tag":40,"props":589,"children":591},{"id":590},"cannot",[592],{"type":45,"value":593},"CANNOT",{"type":39,"tag":521,"props":595,"children":596},{},[597,607,617,627],{"type":39,"tag":525,"props":598,"children":599},{},[600,605],{"type":39,"tag":108,"props":601,"children":602},{},[603],{"type":45,"value":604},"Suppressions are global by default",{"type":45,"value":606}," — A bounce or spam report on ANY email suppresses the address from ALL future sends. Use ASM groups to scope unsubscribes.",{"type":39,"tag":525,"props":608,"children":609},{},[610,615],{"type":39,"tag":108,"props":611,"children":612},{},[613],{"type":45,"value":614},"Removing a suppression does not fix the underlying issue",{"type":45,"value":616}," — Deleting a bounce record lets you retry, but the mailbox is likely still invalid. Re-sending to hard bounces damages sender reputation.",{"type":39,"tag":525,"props":618,"children":619},{},[620,625],{"type":39,"tag":108,"props":621,"children":622},{},[623],{"type":45,"value":624},"Cannot prevent spam report suppressions",{"type":45,"value":626}," — When a recipient marks you as spam, the suppression is automatic and cannot be overridden.",{"type":39,"tag":525,"props":628,"children":629},{},[630,635],{"type":39,"tag":108,"props":631,"children":632},{},[633],{"type":45,"value":634},"Cannot bulk-remove suppressions by domain",{"type":45,"value":636}," — Must remove individually by email address via API.",{"type":39,"tag":54,"props":638,"children":639},{},[],{"type":39,"tag":40,"props":641,"children":643},{"id":642},"next-steps",[644],{"type":45,"value":645},"Next Steps",{"type":39,"tag":521,"props":647,"children":648},{},[649,665,680],{"type":39,"tag":525,"props":650,"children":651},{},[652,657,659],{"type":39,"tag":108,"props":653,"children":654},{},[655],{"type":45,"value":656},"Send email:",{"type":45,"value":658}," ",{"type":39,"tag":117,"props":660,"children":662},{"className":661},[],[663],{"type":45,"value":664},"twilio-sendgrid-email-send",{"type":39,"tag":525,"props":666,"children":667},{},[668,673,674],{"type":39,"tag":108,"props":669,"children":670},{},[671],{"type":45,"value":672},"Delivery tracking:",{"type":45,"value":658},{"type":39,"tag":117,"props":675,"children":677},{"className":676},[],[678],{"type":45,"value":679},"twilio-sendgrid-webhooks",{"type":39,"tag":525,"props":681,"children":682},{},[683,688,689],{"type":39,"tag":108,"props":684,"children":685},{},[686],{"type":45,"value":687},"Account setup:",{"type":45,"value":658},{"type":39,"tag":117,"props":690,"children":692},{"className":691},[],[693],{"type":45,"value":694},"twilio-sendgrid-account-setup",{"type":39,"tag":696,"props":697,"children":698},"style",{},[699],{"type":45,"value":700},"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":702,"total":881},[703,719,739,750,762,775,792,808,824,837,851,869],{"slug":704,"name":704,"fn":705,"description":706,"org":707,"tags":708,"stars":23,"repoUrl":24,"updatedAt":718},"twilio-account-setup","configure Twilio accounts and credentials","Create and configure a Twilio account from scratch. Covers free trial signup, trial limitations, getting credentials (Account SID and Auth Token), buying a phone number, verifying recipient numbers for trial use, SDK installation, first API call, subaccount management (creation, inheritance, credential isolation, limits), and enabling specific products (AI Assistants, Conversations, Verify, ConversationRelay, WhatsApp). Use this skill before any other Twilio skill if you do not yet have a Twilio account or need to enable a product. For Organization-level governance (SSO, SCIM, multi-team), see `twilio-organizations-setup`.\n",{"slug":8,"name":9,"logoUrl":10,"githubOrg":8},[709,712,715],{"name":710,"slug":711,"type":15},"API Development","api-development",{"name":713,"slug":714,"type":15},"Communications","communications",{"name":716,"slug":717,"type":15},"SMS","sms","2026-08-01T05:43:28.968968",{"slug":720,"name":720,"fn":721,"description":722,"org":723,"tags":724,"stars":23,"repoUrl":24,"updatedAt":738},"twilio-agent-augmentation-architect","augment human agents with AI intelligence","Planning skill for augmenting human agents with real-time AI intelligence. Qualifies the developer's use case across coaching, compliance, QA, and routing to recommend the right Conversation Intelligence + Conversation Memory + TaskRouter architecture. Handles both \"I want to add AI coaching to my call center\" and \"configure Conversation Intelligence operators for script adherence.\"\n",{"slug":8,"name":9,"logoUrl":10,"githubOrg":8},[725,728,731,734,737],{"name":726,"slug":727,"type":15},"Agents","agents",{"name":729,"slug":730,"type":15},"AI","ai",{"name":732,"slug":733,"type":15},"Coaching","coaching",{"name":735,"slug":736,"type":15},"QA","qa",{"name":9,"slug":8,"type":15},"2026-07-17T06:07:58.250609",{"slug":740,"name":740,"fn":741,"description":742,"org":743,"tags":744,"stars":23,"repoUrl":24,"updatedAt":749},"twilio-agent-connect","connect AI agents to Twilio channels","Connect third-party AI agents (OpenAI, Bedrock, LangChain, Microsoft Foundry) to Twilio's communication channels using the Twilio Agent Connect SDK. Covers identity resolution, memory and context management via Conversation Memory, conversation orchestration via Conversation Orchestrator, multi-channel handling (Voice, SMS, RCS, WhatsApp, Chat), and AI-to-human escalation. Use this skill when integrating an existing LLM agent with Twilio services.\n",{"slug":8,"name":9,"logoUrl":10,"githubOrg":8},[745,746,747,748],{"name":726,"slug":727,"type":15},{"name":710,"slug":711,"type":15},{"name":713,"slug":714,"type":15},{"name":9,"slug":8,"type":15},"2026-07-17T06:06:05.217098",{"slug":751,"name":751,"fn":752,"description":753,"org":754,"tags":755,"stars":23,"repoUrl":24,"updatedAt":761},"twilio-ai-agent-architect","plan Twilio conversational AI agents","Planning skill for AI-powered conversational agents. Qualifies the developer's use case across outcome sophistication, entry point, and customer profile to recommend the right Twilio Conversations architecture and implementation skills. Handles both high-level requests (\"build me a voice AI assistant\") and specific ones (\"integrate ConversationRelay with my OpenAI backend\").\n",{"slug":8,"name":9,"logoUrl":10,"githubOrg":8},[756,757,760],{"name":726,"slug":727,"type":15},{"name":758,"slug":759,"type":15},"Architecture","architecture",{"name":9,"slug":8,"type":15},"2026-07-17T06:07:48.883723",{"slug":763,"name":763,"fn":764,"description":765,"org":766,"tags":767,"stars":23,"repoUrl":24,"updatedAt":774},"twilio-call-recordings","record and manage Twilio voice calls","Record Twilio voice calls correctly. Covers the critical distinction between Record verb (voicemail) and Dial record (call recording), dual-channel for QA, mid-call pause for PCI, Conference recording, and the ConversationRelay workaround. Use this skill whenever you need to capture call audio for compliance, QA, or analytics.\n",{"slug":8,"name":9,"logoUrl":10,"githubOrg":8},[768,771,772,773],{"name":769,"slug":770,"type":15},"Audio","audio",{"name":13,"slug":14,"type":15},{"name":735,"slug":736,"type":15},{"name":9,"slug":8,"type":15},"2026-07-17T06:07:55.268412",{"slug":776,"name":776,"fn":777,"description":778,"org":779,"tags":780,"stars":23,"repoUrl":24,"updatedAt":791},"twilio-cli-reference","manage Twilio resources via CLI","Twilio CLI reference for managing Twilio resources from the terminal. Covers installation, credential profiles, phone number provisioning, sending SMS and email, webhook configuration, local development with a tunneling service, debugging with watch and logs, serverless deployment, and plugin ecosystem. Use when the developer asks to \"just do it\", \"set this up\", \"run a command\", mentions \"CLI\", \"command line\", or \"terminal\", or when an AI agent can execute a task directly instead of writing application code.\n",{"slug":8,"name":9,"logoUrl":10,"githubOrg":8},[781,784,787,790],{"name":782,"slug":783,"type":15},"CLI","cli",{"name":785,"slug":786,"type":15},"Local Development","local-development",{"name":788,"slug":789,"type":15},"Operations","operations",{"name":9,"slug":8,"type":15},"2026-07-17T06:07:54.925664",{"slug":793,"name":793,"fn":794,"description":795,"org":796,"tags":797,"stars":23,"repoUrl":24,"updatedAt":807},"twilio-compliance-onboarding","manage Twilio messaging and voice compliance","Registrations required BEFORE Twilio traffic works. Covers messaging programs (A2P 10DLC, toll-free verification, WhatsApp WABA, RCS, short code, alphanumeric sender) and voice trust programs (STIR\u002FSHAKEN, Voice Integrity, Branded Calling, CNAM). Each number\u002Fsender type has its own program — registration blocks traffic until complete.\n",{"slug":8,"name":9,"logoUrl":10,"githubOrg":8},[798,799,802,803,804],{"name":13,"slug":14,"type":15},{"name":800,"slug":801,"type":15},"Messaging","messaging",{"name":716,"slug":717,"type":15},{"name":9,"slug":8,"type":15},{"name":805,"slug":806,"type":15},"WhatsApp","whatsapp","2026-07-17T06:05:47.897229",{"slug":809,"name":809,"fn":810,"description":811,"org":812,"tags":813,"stars":23,"repoUrl":24,"updatedAt":823},"twilio-compliance-traffic","ensure compliance for Twilio messaging traffic","Rules you must follow for Twilio messaging and voice traffic. Covers TCPA (consent tiers, quiet hours, DNC), GDPR (EU consent, right to deletion), PCI DSS (payment recording, Pay verb), HIPAA (BAA, PHI), FDCPA (debt collection limits), CAN-SPAM, WhatsApp policies, SHAKEN\u002FSTIR, and consent management patterns. Use this skill proactively when developers have working traffic to ensure they follow the rules.\n",{"slug":8,"name":9,"logoUrl":10,"githubOrg":8},[814,815,816,819,822],{"name":13,"slug":14,"type":15},{"name":800,"slug":801,"type":15},{"name":817,"slug":818,"type":15},"Regulatory Compliance","regulatory-compliance",{"name":820,"slug":821,"type":15},"Security","security",{"name":9,"slug":8,"type":15},"2026-07-17T06:07:55.952779",{"slug":825,"name":825,"fn":826,"description":827,"org":828,"tags":829,"stars":23,"repoUrl":24,"updatedAt":836},"twilio-conference-calls","build multi-party calls with Twilio Conference","Build multi-party calls using Twilio Conference. Covers warm transfer, cold transfer, coaching (whisper), hold vs mute, participant modes, and supervisor barge. Use this skill for any contact center, support line, or scenario requiring transfers, holds, or multi-party calls.\n",{"slug":8,"name":9,"logoUrl":10,"githubOrg":8},[830,831,832,835],{"name":769,"slug":770,"type":15},{"name":713,"slug":714,"type":15},{"name":833,"slug":834,"type":15},"Meetings","meetings",{"name":9,"slug":8,"type":15},"2026-07-17T06:07:55.603708",{"slug":838,"name":838,"fn":839,"description":840,"org":841,"tags":842,"stars":23,"repoUrl":24,"updatedAt":850},"twilio-content-template-builder","create and send message templates with Twilio","Create, manage, and send message templates using Twilio's Content API. Covers template creation for WhatsApp, SMS, RCS, and MMS; variable usage; WhatsApp Meta approval; and sending templates via ContentSid. Use this skill when building structured messages that require pre-approval or consistent formatting across channels.\n",{"slug":8,"name":9,"logoUrl":10,"githubOrg":8},[843,844,845,846,849],{"name":20,"slug":21,"type":15},{"name":800,"slug":801,"type":15},{"name":716,"slug":717,"type":15},{"name":847,"slug":848,"type":15},"Templates","templates",{"name":9,"slug":8,"type":15},"2026-07-17T06:04:26.637309",{"slug":852,"name":852,"fn":853,"description":854,"org":855,"tags":856,"stars":23,"repoUrl":24,"updatedAt":868},"twilio-conversation-intelligence","build conversation intelligence pipelines","Twilio Conversation Intelligence development guide. Use when building real-time or post-call conversation analysis, language operator pipelines, sentiment analysis, agent assist, cross-channel analytics, or querying aggregated conversation insights (sentiment trends, escalation rates, dashboards).",{"slug":8,"name":9,"logoUrl":10,"githubOrg":8},[857,858,861,864,867],{"name":726,"slug":727,"type":15},{"name":859,"slug":860,"type":15},"Analytics","analytics",{"name":862,"slug":863,"type":15},"Monitoring","monitoring",{"name":865,"slug":866,"type":15},"NLP","nlp",{"name":9,"slug":8,"type":15},"2026-07-17T06:07:52.545387",{"slug":870,"name":870,"fn":871,"description":872,"org":873,"tags":874,"stars":23,"repoUrl":24,"updatedAt":880},"twilio-conversation-memory","manage conversation memory with Twilio","Store and retrieve conversation context using Twilio Conversation Memory. Covers Memory Store provisioning, profile management, traits, observations, conversation summaries, and semantic Recall. Use this skill to give AI agents or human agents persistent memory of conversations across sessions and channels.\n",{"slug":8,"name":9,"logoUrl":10,"githubOrg":8},[875,876,879],{"name":726,"slug":727,"type":15},{"name":877,"slug":878,"type":15},"Memory","memory",{"name":9,"slug":8,"type":15},"2026-07-17T06:04:19.526724",57,{"items":883,"total":881},[884,890,898,905,911,918,925],{"slug":704,"name":704,"fn":705,"description":706,"org":885,"tags":886,"stars":23,"repoUrl":24,"updatedAt":718},{"slug":8,"name":9,"logoUrl":10,"githubOrg":8},[887,888,889],{"name":710,"slug":711,"type":15},{"name":713,"slug":714,"type":15},{"name":716,"slug":717,"type":15},{"slug":720,"name":720,"fn":721,"description":722,"org":891,"tags":892,"stars":23,"repoUrl":24,"updatedAt":738},{"slug":8,"name":9,"logoUrl":10,"githubOrg":8},[893,894,895,896,897],{"name":726,"slug":727,"type":15},{"name":729,"slug":730,"type":15},{"name":732,"slug":733,"type":15},{"name":735,"slug":736,"type":15},{"name":9,"slug":8,"type":15},{"slug":740,"name":740,"fn":741,"description":742,"org":899,"tags":900,"stars":23,"repoUrl":24,"updatedAt":749},{"slug":8,"name":9,"logoUrl":10,"githubOrg":8},[901,902,903,904],{"name":726,"slug":727,"type":15},{"name":710,"slug":711,"type":15},{"name":713,"slug":714,"type":15},{"name":9,"slug":8,"type":15},{"slug":751,"name":751,"fn":752,"description":753,"org":906,"tags":907,"stars":23,"repoUrl":24,"updatedAt":761},{"slug":8,"name":9,"logoUrl":10,"githubOrg":8},[908,909,910],{"name":726,"slug":727,"type":15},{"name":758,"slug":759,"type":15},{"name":9,"slug":8,"type":15},{"slug":763,"name":763,"fn":764,"description":765,"org":912,"tags":913,"stars":23,"repoUrl":24,"updatedAt":774},{"slug":8,"name":9,"logoUrl":10,"githubOrg":8},[914,915,916,917],{"name":769,"slug":770,"type":15},{"name":13,"slug":14,"type":15},{"name":735,"slug":736,"type":15},{"name":9,"slug":8,"type":15},{"slug":776,"name":776,"fn":777,"description":778,"org":919,"tags":920,"stars":23,"repoUrl":24,"updatedAt":791},{"slug":8,"name":9,"logoUrl":10,"githubOrg":8},[921,922,923,924],{"name":782,"slug":783,"type":15},{"name":785,"slug":786,"type":15},{"name":788,"slug":789,"type":15},{"name":9,"slug":8,"type":15},{"slug":793,"name":793,"fn":794,"description":795,"org":926,"tags":927,"stars":23,"repoUrl":24,"updatedAt":807},{"slug":8,"name":9,"logoUrl":10,"githubOrg":8},[928,929,930,931,932],{"name":13,"slug":14,"type":15},{"name":800,"slug":801,"type":15},{"name":716,"slug":717,"type":15},{"name":9,"slug":8,"type":15},{"name":805,"slug":806,"type":15}]