Overview

A message template is a reusable template for the message content of your mailer — the handwritten-style text body, replacement variables, QR code configuration, and font and style settings. Depending on the mail type, this content appears in a different location:

Postcard — the back side
Letter — the cover letter text
Notecard — the interior

Every time you send a mailer or trigger a campaign, you attach a message template. The template renders per recipient, filling in replacement variables (such as %FIRST_NAME%) with real data. Because templates are reusable, you can attach the same template to multiple campaigns, and changes take effect on the next send. Message templates are created and managed through these endpoints.

What a Message Template Contains

Field	Description
Message body	The handwritten-style text
Replacement variables	`%FIRST_NAME%`, `%YOUR_COMPANY%`, `%CUSTOM1%`, etc.
QR code Url	QR Code Destination URL
QR code CC emails	Additional email addresses to notify on QR scans
Background/stationery	Custom message background image
Handwriting style	Chosen from the available fonts
Realism Mode	Adds crossouts and imperfections
Additional pages	Extra pages (letters only)
Gift card brand + amount	The gift card to include (gift card mailer type only)
Gift card gating URL/YouTube	URL or YouTube video the recipient must view to unlock the gift card

Replacement Variables

Replacement variables in a message are filled in for each recipient when the piece is printed. Write them as %NAME%; matching ignores case.

Variable	Prints
`%FIRST_NAME%`, `%LAST_NAME%`, `%FULL_NAME%`	The recipient’s name. `%NAME%` is the same as `%FULL_NAME%`.
`%COMPANY%`	The recipient’s company. Blank when the company is `Or Current Resident`.
`%ADDRESS%`, `%ADDRESS2%`, `%CITY%`, `%STATE%`, `%ZIP%`	The recipient’s address. `%PROVINCE%` is the same as `%STATE%`, and `%POSTAL_CODE%` the same as `%ZIP%`.
`%STREET_ONLY%`	The recipient’s street name without the house number, or `Your Street` when there isn’t one, such as a PO box.
`%CUSTOM1%` to `%CUSTOM10%`	The recipient’s custom fields. `%FIELD1%` to `%FIELD10%` are the same.
`%ABSENTEE_STREET%`	The street line of the recipient’s absentee (property) address, or the recipient’s own street when there isn’t one.
`%NEIGHBORS_STREET%`	Like `%ABSENTEE_STREET%`, but prints `Your Neighbor's Property` when there’s no absentee address. Used in neighbor mailings.
`%YOUR_FULL_NAME%`, `%YOUR_FIRST_NAME%`, `%YOUR_COMPANY%`, `%YOUR_PHONE%`, `%YOUR_EMAIL%`	Your own details, from your account’s branding.
`%YOUR_AI_PHONE%`	Your AI Receptionist phone number, or the sub-account’s own number when you send as a sub-account. A send that uses it is refused while the account (or sub-account) has no AI Receptionist number.
`%CURRENT_DAY%`	The date the piece is printed, such as `May 6, 2026`.
`%CURRENT_MONTH%`	The month the piece is printed, such as `October`.

A variable that isn’t in this list is removed from the message when it prints, so check the spelling. In image templates and QR code URLs, write variables with tildes instead, such as ~CUSTOM1~ or ~CURRENT_MONTH~.

Gift Cards & Additional Pages

Templates can carry gift card details (giftcard_brand_code, giftcard_amount) and, for letter templates, an additional_pages PDF URL to attach extra pages.

Get Started

Authentication

API Endpoints

Examples

Usage

Overview

What a Message Template Contains

Replacement Variables

Gift Cards & Additional Pages

​Overview

​What a Message Template Contains

​Replacement Variables

​Gift Cards & Additional Pages

Overview

What a Message Template Contains

Replacement Variables

Gift Cards & Additional Pages