Guides

Create a template

Author, preview, and publish an email template.

Templates are the emails you send. They're authored with your company's brand and can reference variables you pass at send time.

Create a draft

Create a template in the dashboard (or via MCP) and give it a slug — the stable id you'll use when sending (e.g. welcome). Write the subject and body; reference variables like {firstName}.

Preview with sample data

Render the template with sample props to see the real output, and send a test to yourself before publishing.

Publish

Publish the template to make it sendable. Published versions are immutable — any later edit creates a new draft version, which you publish in turn. In-flight sends and automations keep using the version they started with.

Sending a template with no published version returns 409 template_not_published. Publish first.

Variables

Pass template variables as props on the send:

{
  "to": "[email protected]",
  "template": "welcome",
  "props": { "firstName": "Jane", "plan": "Pro" }
}

Next steps

On this page