Core concepts

Personalization

Merge variables for subjects and bodies, with fallbacks.

Use merge variables to personalize subjects and bodies per recipient.

Subjects and HTML bodies support {{token}} merge variables. They're resolved at send time from the matching contact (looked up by the recipient's email). Provide a fallback after a pipe so the message reads well even when the contact or field is missing: {{name|there}}.

json
{
"subject": "Your order, {{name|there}}",
"html": "<p>Hi {{name|there}}, your plan is {{plan|Free}}.</p>"
}

Built-in variables

TokenDescription
{{name}}The contact's name, when the recipient is one of your contacts.
{{email}}The recipient's email address.
{{unsubscribe_url}}A working one-click unsubscribe link for this recipient.
{{from}}The sender address used for this message.

Custom fields

Any custom field you define is available by its key, e.g. {{company}}. Manage custom fields in your dashboard, and set their values when you create or update a contact via custom_fields.