Templates

Create and manage reusable, versioned email templates, then send from them by reference.

templates are reusable, versioned email bodies. Create a template once, then send from it by passing templateId on a message instead of inline subject/html, so content lives in one place and can change without a code deploy.

What you can do

  • Manage templates, create, retrieve, list, update, and remove.
  • Render a template to its final HTML, and preview / validate its content before publishing.
  • Approve a template to mark it ready for sending.

Sending from a template

Reference a stored template from the send body instead of inline content:

{
  "to": [{ "email": "ada@example.com" }],
  "channel": "email",
  "email": { "templateId": "tmpl_..." }
}

Shared conventions (auth, status codes, errors, pagination) are in the REST API reference. Per-operation request and response detail is in the sidebar.

On this page