AGENT SKILL

twilio-sendgrid-email-settings

Configure SendGrid dynamic templates (Handlebars), tracking settings (opens, clicks, subscriptions), link branding for custom tracking domains, and content types (HTML, plain text, AMP). Use when customizing SendGrid email content, tracking behavior, or branded links. Requires a SendGrid API key (SG.-prefix) — not applicable to the Twilio Email API (comms.twilio.com).

License 许可
MIT
最近更新
2026-07-19
Stars
★ 1
Forks
1

01 前言 Front Matter

name
twilio-sendgrid-email-settings
description
Configure SendGrid dynamic templates (Handlebars), tracking settings (opens, clicks, subscriptions), link branding for custom tracking domains, and content types (HTML, plain text, AMP). Use when customizing SendGrid email content, tracking behavior, or branded links. Requires a SendGrid API key (SG.-prefix) — not applicable to the Twilio Email API (comms.twilio.com).

02 资源文件 1

03 SKILL.md 正文

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 via dynamic_template_data.
  • Undefined template variables are silent — Missing keys in dynamic_template_data render 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

04 同仓库更多 Skills

zfifteen
zfifteen/skills-catalog

Zotero

Use Zotero Desktop from Codex to enable/probe the local API, search a local Zotero library, list items/collections/tags, export BibTeX, insert citation keys into LaTeX or Markdown drafts, read indexed full text when requested, and import BibTeX/RIS records into Zotero through the connector server. Use when the user mentions Zotero, citations, references.bib, BibTeX export, local Zotero API, localhost:23119, or adding citations from a Zotero library.

★ 1
zfifteen
zfifteen/skills-catalog

zoom-apps-sdk

Use when using Apps SDK.

★ 1
zfifteen
zfifteen/skills-catalog

youtube

Obtain accurate, timestamped YouTube video transcripts (preferring manual captions over auto-generated) as the primary deliverable, then derive summaries, key claims, or notes from that transcript. Use when the user provides a YouTube URL (or video ID) and wants the transcript, a faithful summary, key claims with attribution, timestamped notes, or "what does this video actually say". The skill is transcript-first: never substitute metadata, title, description, or search snippets for the spoken content. Triggers: "youtube transcript", "get the transcript of this video", "summarize this youtube video", "what did they say in https://youtube.com/...", "key claims from this talk".

★ 1
zfifteen
zfifteen/skills-catalog

yeet

Publish local changes to GitHub by confirming scope, committing intentionally, pushing the branch, and opening a draft PR through the GitHub app from this plugin, with `gh` used only as a fallback where connector coverage is insufficient.

★ 1
zfifteen
zfifteen/skills-catalog

x-post-creator

Create X-ready post threads and co-located story packages from the active conversation or referenced project material. Use when the user says turn this into an X-post, /x-post, make this into an X thread, or wants plain-language social posts with supporting images saved to docs/x-posts/[story-name]/.

★ 1
zfifteen
zfifteen/skills-catalog

x-api

Search, read, and write X posts through the local X API MCP server (the same backend used by the Codex x-api skill). Use for searching X/x.com, reading threads and replies, creating lists, staging/publishing posts for @alltheputs, finding high-visibility reply targets for research outreach, ingesting public context, or any request that mentions /x-api or "search X".

★ 1