Get templates
curl -u 'username:password' 'https://listmonk.mysite.com/api/templates'
Permission: templates:get
Query Parameters
If true, excludes template body from response for faster loading
Response
Array of template objects
Template type: campaign or tx (transactional)
Email subject (for tx templates only)
Original template source (for visual editor templates)
Whether this is the default template
Get template
curl -u 'username:password' 'https://listmonk.mysite.com/api/templates/1'
Permission: templates:get
Path Parameters
Query Parameters
If true, excludes template body
Response
Returns a single template object
Create template
curl -u 'username:password' 'https://listmonk.mysite.com/api/templates' \
-H 'Content-Type: application/json' \
-d '{
"name": "Newsletter Template",
"type": "campaign",
"body": "<!DOCTYPE html><html><body>{{ template \"content\" . }}</body></html>"
}'
Permission: templates:manage
Request Body
Template name (max 2000 characters)
Template type:
campaign: For email campaigns (must contain {{ template "content" . }} placeholder)tx: For transactional emails
Template HTML body. Campaign templates must include the {{ template "content" . }} placeholder where campaign content will be inserted.
Email subject line (required for tx templates, ignored for campaign templates)
Original template source for visual editor templates
Response
Returns the created template object
Example: Campaign Template
<!DOCTYPE html>
<html>
<head>
<meta charset="utf-8">
<style>
body { font-family: Arial, sans-serif; }
.container { max-width: 600px; margin: 0 auto; }
</style>
</head>
<body>
<div class="container">
<h1>{{ .Campaign.Name }}</h1>
{{ template "content" . }}
<footer>
<a href="{{ UnsubscribeURL }}">Unsubscribe</a>
</footer>
</div>
</body>
</html>
Example: Transactional Template
<!DOCTYPE html>
<html>
<body>
<h1>Welcome {{ .Subscriber.Name }}!</h1>
<p>Your account has been created.</p>
{{ if .Tx.Data.username }}
<p>Username: {{ .Tx.Data.username }}</p>
{{ end }}
</body>
</html>
Update template
curl -u 'username:password' -X PUT 'https://listmonk.mysite.com/api/templates/1' \
-H 'Content-Type: application/json' \
-d '{
"name": "Updated Template Name",
"body": "<!DOCTYPE html><html><body>{{ template \"content\" . }}</body></html>"
}'
Permission: templates:manage
Path Parameters
Request Body
Email subject (for tx templates)
The template type cannot be changed after creation. Only provided fields will be updated.
Set default template
curl -u 'username:password' -X PUT 'https://listmonk.mysite.com/api/templates/1/default'
Permission: templates:manage
Path Parameters
Template ID to set as default
Response
Returns the updated list of all templates
Delete template
curl -u 'username:password' -X DELETE 'https://listmonk.mysite.com/api/templates/1'
Permission: templates:manage
Path Parameters
Response
Returns true on successful deletion
Campaigns using this template will not be affected as the template body is compiled into the campaign when it’s created.
Preview template
curl -u 'username:password' 'https://listmonk.mysite.com/api/templates/1/preview'
Permission: templates:get
Path Parameters
Response
Returns rendered HTML preview with sample subscriber and campaign data.
Preview template body
curl -u 'username:password' -X POST 'https://listmonk.mysite.com/api/templates/preview' \
-d 'template_type=campaign' \
-d 'body=<!DOCTYPE html><html><body>{{ template "content" . }}</body></html>'
Permission: templates:get
Request Body
Template type: campaign or tx
Template HTML body to preview
Response
Returns rendered HTML preview.
Template Variables
Templates support Go template syntax with the following variables:
Campaign Templates
First name (parsed from full name)
Last name (parsed from full name)
Custom attributes (access with .Subscriber.Attribs.key)
Transactional Templates
Custom data passed in API request (access with .Tx.Data.key)
Template Functions
{{ TrackLink "https://example.com" }} - Creates a tracked link
{{ TrackView }} - Inserts a tracking pixel
{{ UnsubscribeURL }} - Generates unsubscribe URL
{{ ManageURL }} - Generates subscription management URL
{{ OptinURL }} - Generates opt-in confirmation URL
{{ Date "2006-01-02" }} - Formats current date
