Email Template

Email Template

An Email Template defines reusable email content with variable placeholders ({{variable}}) for dynamic personalization.

Schema

interface EmailTemplate {
  id: string; // "emt_..." - Unique identifier
  account_id: string; // Owning account
  name: string; // Template name
  event_type: string; // Business event (e.g., "user_welcome")
  editor: "grapesjs_mjml"; // Template editor
  editor_state: string; // Serialized editor state
  mjml: string; // MJML source
  subject_template: string; // Subject with variables
  body_text_template: string; // Plain text with variables
  body_html_template: string; // HTML with variables
  archived_at: string | null; // Archived timestamp
}

Properties

Property	Type	Description
id	string	KSUID with emt_ prefix
account_id	string	Account that owns template
name	string	Human-readable name
event_type	string	Event trigger name
editor	string	Editor type
editor_state	string	Serialized editor state
mjml	string	MJML source
subject_template	string	Subject line template
body_text_template	string	Plain text body template
body_html_template	string	HTML body template
archived_at	string?	Archived timestamp

Variable Syntax

Use {{variable_name}} for substitution:

Subject: Welcome, {{name}}!

Dear {{name}},

Your account {{account_name}} is ready.

Best regards,
The {{company}} Team

Usage

Send with template:

{
  "template_id": "emt_...",
  "to": [{ "email": "user@example.com" }],
  "variables": {
    "name": "Jane",
    "account_name": "Acme Corp",
    "company": "Example Inc"
  }
}

Example

{
  "id": "emt_2kHfPZcN9xW4mE8RtY7vB",
  "account_id": "acc_1jGePYbM8wV3lD7QsX6uA",
  "name": "welcome",
  "event_type": "user_welcome",
  "editor": "grapesjs_mjml",
  "editor_state": "{}",
  "mjml": "<mjml><mj-body></mj-body></mjml>",
  "subject_template": "Welcome to {{company}}, {{name}}!",
  "body_text_template": "Hi {{name}},\n\nWelcome to {{company}}...",
  "body_html_template": "<h1>Welcome, {{name}}!</h1>...",
  "archived_at": null
}

Related

• Email Message - Sent messages
• Email - Email infrastructure