Create custom email templates for listmonk using Tabular

Overview

This integration allows you to seamlessly use your Tabular emails in your self-hosted listmonk instance. It automatically adds a campaign or transactional template to your listmonk installation that uses your Tabular email template.

How it works

listmonk is a self-hosted newsletter and mailing list manager. You can use listmonk to manage and send email marketing campaigns and transactional emails. It is free and open source software licensed under AGPLv3. It is a binary application that you can run manually or via Docker, and requires a Postgres database instance.

In listmonk you can store email templates with two types: campaign and transactional. Campaign templates can be used in email campaigns, and transactional templates in your transactional emails. With Tabular's listmonk integration you can create and update your listmonk email templates. Build email templates in Tabular and directly upload them as either campaign or transactional templates to listmonk.

How to export an email template to listmonk?

In listmonk

1. Navigate to Users > Users via the side menu in listmonk. You will find an overview of the Users in your listmonk installation.
2. Click on the New button to add a new user
3. Select the new user to be an API user, provide a username, and a role with permissions to create and update templates
4. Copy the token that is generated to your clipboard or temporarily store it somewhere. We will use this generated token in our next steps.

In Tabular

1. Open the Tabular email you want to upload to listmonk
2. If you want to upload the email as a campaign template please note that listmonk requires you to add their template markup tag {{ template "content" . }} exactly once in every marketing email template. Listmonk requires this so you specify a section where you can input custom content via listmonk. For adding the tag {{ template "content" . }} we recommend to add this snippet of text inside of a code block.
3. Click on Use email in the upper-right corner of the email builder
4. From the modal that appears, click on the Integrations tab
5. Select listmonk from the available integrations options
6. Give a name to your authorization
7. Provide the base URL to your listmonk installation, the username of the listmonk API user you created in the previous steps, and paste the corresponding API token in the API token field
8. Click Add authorization
9. You now see your listmonk authorization has been added to your list of authorized integrations
10. Click on the Connect to button and select campaign templates from the dropdown if you want to upload your email as a campaign template. If you want to upload your email as a transactional template select transactional templates.
11. Tabular will now attempt to create an email template in your listmonk instance that uses the Tabular email template
12. If the template record was created successfully, you will see that an item has been added to the Your email is currently connected to list
13. From this list you can click on Upload email to upload any new versions of your email to the listmonk template. This will overwrite the email template in the connected listmonk template. You can also click again on Connect to > transaction templates / transactional templates, to create a new template.
14. If you choose to upload the Tabular email as a listmonk transactional template, you can also manage the subject line for that template in Tabular's email builder. Open the Checklist by clicking on the check icon in the upper-right corner of the email builder. Open the Write a subject line tab, and configure the subject line that you want to use for your listmonk transactional template.