Twilio Sendgrid Email Settings
- 108 installs
- 26 repo stars
- Updated July 29, 2026
- twilio/ai
twilio-sendgrid-email-settings is an agent skill that explains SendGrid dynamic templates, tracking settings, link branding, and email content types for developers using a SendGrid API key.
About
The twilio-sendgrid-email-settings skill documents how SendGrid email content, personalization, and tracking are configured through the Console or API. It covers dynamic templates with Handlebars helpers such as if, each, equals, and formatDate, plus the limitation that custom helpers and inline partials are not supported. Developers learn tracking settings for opens, clicks, subscription footers, and Google Analytics UTM injection, including caveats that open pixels are unreliable under Apple Mail Privacy Protection. Link branding explains replacing default ct.sendgrid.net redirect domains with a CNAME-backed custom subdomain to improve deliverability. Content-type priority orders AMP, HTML, and plain text, with guidance to always ship at least HTML and plain text. CANNOT rules warn that undefined dynamic_template_data keys render silently and that personalization subject overrides bypass template subjects. The skill requires a SendGrid API key with an SG. prefix and is not for the Twilio Email API at comms.twilio.com. Use when customizing SendGrid template behavior, tracking, or branded click domains before sending mail.
- Documents supported Handlebars helpers and explicitly lists unsupported custom helpers and partials.
- Explains open, click, subscription, and GA tracking settings with deliverability caveats.
- Covers link branding via CNAME to replace default SendGrid redirect domains.
- Defines AMP, HTML, and plain-text content priority for multi-part messages.
- Lists CANNOT constraints such as unreliable open tracking and silent missing template variables.
Twilio Sendgrid Email Settings by the numbers
- 108 all-time installs (skills.sh)
- +7 installs in the week ending Aug 5, 2026 (Skillselion tracking)
- Ranked #2,954 of 4,347 Backend & APIs skills by installs in the Skillselion catalog
- Data as of Aug 5, 2026 (Skillselion catalog sync)
twilio-sendgrid-email-settings capabilities & compatibility
- Capabilities
- handlebars dynamic template helper reference · open and click tracking configuration guidance · link branding cname setup · multipart content type priority rules · sendgrid api constraint documentation
- Works with
- gmail
- Use cases
- api development · email
- Pricing
- Bring your own API key
What twilio-sendgrid-email-settings says it does
SendGrid email settings control how your messages are constructed, personalized, and tracked.
npx skills add https://github.com/twilio/ai --skill twilio-sendgrid-email-settingsAdd your badge
Show developers this skill is listed on Skillselion. Paste this into your README.
| Installs | 108 |
|---|---|
| repo stars | ★ 26 |
| Last updated | July 29, 2026 |
| Repository | twilio/ai ↗ |
How do I configure SendGrid dynamic templates, tracking pixels, and custom link branding without breaking deliverability?
Configure SendGrid dynamic Handlebars templates, open/click tracking, link branding domains, and HTML/plain/AMP content types for transactional email.
Who is it for?
Developers integrating SendGrid transactional email who need Handlebars template rules, tracking toggles, and branded click domains.
Skip if: Skip for actually sending messages (use twilio-sendgrid-email-send) or Twilio Email API at comms.twilio.com.
When should I use this skill?
User customizes SendGrid email templates, tracking behavior, link branding, or content types before sending.
What you get
Correct template, tracking, branding, and multipart content setup aligned with SendGrid API constraints and documented caveats.
Files
Overview
SendGrid email settings control how your messages are constructed, personalized, and tracked. Most configuration happens in the SendGrid Console, but templates and tracking can also be managed via API.
---
Dynamic Templates
Templates use Handlebars syntax and are managed in Console > Email API > Dynamic Templates. Template IDs start with d-.
Supported Handlebars helpers:
| Helper | Use | Example |
|---|---|---|
if / unless | Conditional | {{#if premium}}Welcome back!{{/if}} |
each | Iteration | {{#each items}}{{this.name}}{{/each}} |
equals / notEquals | Comparison | {{#equals status "active"}}...{{/equals}} |
and / or | Boolean logic | {{#and premium verified}}...{{/and}} |
greaterThan / lessThan | Numeric | {{#greaterThan count 5}}...{{/greaterThan}} |
length | Array/string | {{length items}} |
formatDate | Date format | {{formatDate date "MM/DD/YYYY"}} |
insert | Module insert | {{insert "module_name"}} |
NOT supported: Custom helpers, inline partials, lookup, log, with, blockHelperMissing. SendGrid implements a subset of Handlebars.js.
Template Versions
- Dynamic templates (IDs starting with
d-): Support Handlebars - Legacy transactional templates: Use
-substitution-syntax — not interchangeable with Handlebars
---
Tracking Settings
| Setting | What it does | Caveat |
|---|---|---|
| Open tracking | Inserts a tracking pixel | Unreliable: Apple Mail Privacy Protection inflates opens; image-blocking clients produce false negatives |
| Click tracking | Rewrites URLs through SendGrid's redirect | Can trigger spam filters on some domains |
| Subscription tracking | Adds unsubscribe footer | Required for CAN-SPAM compliance |
| Google Analytics | Adds UTM parameters | Only for marketing campaigns |
Configure per-message or account-wide in Console > Settings > Tracking.
---
Link Branding (Custom Tracking Domains)
By default, click-tracked links route through url####.ct.sendgrid.net. Link Branding lets you use your own domain (e.g., links.yourdomain.com) instead, which improves deliverability and builds trust.
Setup: Console > Settings > Sender Authentication > Link Branding
Requires a CNAME DNS record pointing your subdomain to sendgrid.net. Validate via API: GET /v3/whitelabel/links/{id}/validate
---
Content Type Priority
When sending multiple content types, email clients display in this priority:
1. text/x-amp-html (AMP — only in supporting clients, requires sender registration) 2. text/html (standard — most clients) 3. text/plain (fallback)
Always include at least text/plain and text/html.
---
CANNOT
- Cannot use custom Handlebars helpers — Only the built-in set listed above.
- Cannot guarantee open tracking accuracy — Pixel-based tracking is fundamentally unreliable. Do not use for business-critical logic.
- Personalizations `subject` is a plain string override — It bypasses the template subject. To use dynamic subjects, set Handlebars variables (e.g.,
{{{subject}}}) in the Dynamic Template's subject field and pass values viadynamic_template_data. - Undefined template variables are silent — Missing keys in
dynamic_template_datarender as empty strings with no error.
---
Next Steps
- Send email:
twilio-sendgrid-email-send - Delivery tracking:
twilio-sendgrid-webhooks - Manage bounces/unsubscribes:
twilio-sendgrid-suppressions
interface:
display_name: "SendGrid Email Settings"
short_description: "Configure SendGrid dynamic templates, tracking settings (opens, clicks), link branding for custom tracking domains, and content types."
icon_small: "./assets/icon-small.png"
icon_large: "./assets/icon-large.png"
brand_color: "#EF223A"
default_prompt: "How do I set up email tracking and dynamic templates in SendGrid?"
policy:
allow_implicit_invocation: true
Related skills
Lark Openapi ExplorerInstantly explore, test, and generate calls against the full Lark (Feishu) OpenAPI surface without leaving their agent workflow.493k
Lark EventConsume real-time events from Lark/Feishu as structured NDJSON streams inside AI agent workflows.387k16kLark Openapi ExplorerWhen an existing Lark/Feishu skill or CLI command cannot fulfill a specific requirement and they need to discover and invoke the exact native OpenAPI endpoint.386k16k
Just ScrapeQuickly search, crawl, extract structured JSON, or monitor web pages without writing custom scraping code.245k41Lark AppsQuery the current visibility and permission scope of a Lark (Feishu) app without writing HTTP client code.235k16k
Design An InterfaceGenerate multiple radically different interface or API designs in parallel before committing to one.188k198kFAQ
What does twilio-sendgrid-email-settings cover?
SendGrid dynamic Handlebars templates, open/click/subscription tracking, link branding CNAME setup, and HTML/plain/AMP content priorities.
When should I use twilio-sendgrid-email-settings?
When configuring SendGrid template variables, tracking settings, or custom tracking domains before sending email.
Is twilio-sendgrid-email-settings safe to install?
Review the Security Audits panel on this page before installing in production.