Tutorial: how to dynamically add content to a Postmark Template
Fio Dossetto
Recently, Val Sopi from blogstatic contacted our Support team to ask whether he’d be able to turn his blog posts into newsletters and send them out through Postmark, bypassing that famous marketing platform that is as yellow as ours (✉️ 🦍).
Our answer was yes: he could do that by dynamically adding content to existing Postmark Templates —which is something anyone can do if they're using our service to send email. Once Val messaged back to tell us he'd been successful, we invited him to join us on Zoom and demo his process so we could write this tutorial for you.

Val from blogstatic demoing for the Postmark team. We had fun!
Step 0, prerequisite: set up Postmark
To send newsletters (or any other type of email) via Postmark, the prerequisite step is... to set up Postmark. We’ll assume most of you reading this page have already done it—but if that’s not the case, here are the setup instructions you can follow, just like Val did to start using Postmark via our email API.

Postmark's API instructions for sending emails
Step 1: create your email template
Once you’re set up, go to the dashboard, select the existing server you’d like to send your emails from or click Create server to create a new one:

Once in the server, select Templates:

You’ll find yourself in the templates dashboard. From here, you can either Code your own template or use one of our content-ready ones by clicking on Add template:

If you picked Add template, you will be able to choose one of the pre-built ones—they can be edited later! For example, Val picked the Welcome template as his starting point:

Once you pick a layout option from the drop-down menu, the template is ready for editing.

Step 2: set your variables
Before you can add variables into the template, you’ll need to make sure you’ve coded them into your application and in your API call to Postmark. In our documentation, we call this the TemplateModel; at a very basic level, the content could look something like this:
{
“TemplateModel”: {
“user_name”: “Kamala Khan”
_}
_}

Postmark's template API docs
This was Val's API call:
$newClient = new PostmarkClient($token);
$responses = $newClient->sendEmailBatchWithTemplate($messages);
Create a variable for each unique piece of content you’d like to display in your email. For example, here you can see the variables Val created for his TemplateModel in this preview from his code editing tool, like “blog_image”, “post_title”, and “blog_copy”.
Each of these variables corresponds to content generated by Val’s users in the blogstatic application:

Step 3: layer your variables into the template
With your variables set, you can now reference them in your template using Mustachio, Postmark’s simple, yet very powerful template syntax.
You’ll layer the variables into the template HTML where you’d like the dynamic content to appear. Here’s a snapshot of what that looks in Val’s email:

Pro tip: you can take advantage of Postmark’s Template Syntax to conditionally show content. This is really powerful, as you are able to show part of an email Template if it’s present at the time of sending (e.g. you could display an order tracking link if ‘order tracking value’ is passed) or not when the element is not there (e.g. an intro or other information, like a URL).
For example, within blogstatic Val can select which elements of his email should appear (or not) in the newsletter. The section titled Custom message you can see below will show if it’s present vs. not show if the field is left blank once the email is sent via Postmark.
Step 4: send a test email
Use the preview to make sure everything looks good:

Once you’re happy with the results, you’ll want to see how your email renders in an actual client. Click Send test to send a test email using your current test variable:

And here is a preview of Val’s email:

If everything looks good, congratulations: you're ready to send.
Summary
In this tutorial you’ve learned how to dynamically add content to existing Postmark templates. Now you've got the basics mastered, take a look at our transactional email templates to see if any of them spark new ideas for your emails 😉
About Fio Dossetto. Fio was Postmark’s Brand and Editorial lead until June 2023. @content101