Templates API

Templates control the visual design of your newsletters. The API provides read-only access to available templates.

List templates

GET /api/v1/templates

Returns all templates available to your team (both system templates and any custom ones):

{
  "templates": [
    {
      "slug": "clean",
      "name": "Clean",
      "category": "clean",
      "description": "A clean, minimal design with plenty of white space.",
      "system": true,
      "premium": false
    },
    {
      "slug": "bold",
      "name": "Bold",
      "category": "bold",
      "description": "Strong colours and large headings for high-impact newsletters.",
      "system": true,
      "premium": false
    }
  ]
}

Get template details

GET /api/v1/templates/:slug

Using templates

Pass the template_slug when creating or updating a newsletter:

{
  "title": "Weekly Update",
  "template_slug": "bold"
}

If no template is specified, the clean template is used by default.