---
title: "List templates"
method: GET
path: "/email/templates"
tags: ["Templates"]
---

# List templates

`GET /email/templates`

## Request

- Base URL: `https://www.unitpost.com/api/v1`
- URL: `https://www.unitpost.com/api/v1/email/templates`
- Auth: HTTP bearer

Retrieve a list of your email templates, cursor-paginated. List rows omit `html` to keep responses small — fetch a single template with [Retrieve a template](#get-email-templates-id) to get it. Reference a template's `id` when sending with [Send or schedule an email](#post-email) or when creating a campaign. Requires the `templates:read` capability.

## Query parameters

- `limit` integer
- `after` string
- `before` string

## Response `200`

A page of templates.

- object
  - `object` 'list', required
  - `has_more` boolean, required
  - `data` Template[], required
    - `object` 'template', required
    - `id` string, required
    - `name` string, required
    - `subject` string, nullable, required
    - `status` 'draft' | 'published', required
    - `kind` 'simple' | 'designed', required: Which kind of email this is. `simple`: a plain, personal email (the dashboard's Simple editor) — update its body with `text`. `designed`: a designed or raw-HTML email (the Design / Code editor) — update its body with `html`. Sending the other field converts the template to that kind, so keep the kind unless the user asked to switch.
    - `html` string, nullable
    - `warnings` string[]: Create or update with `text` only: markup or styling the Simple format doesn't support that was removed or couldn't be used (an unsupported tag, CSS property or font, an image that can't be sent), in plain words. Absent when nothing was.
    - `created_at` string, required
    - `updated_at` string, required

## Other responses

- `401`: Missing or invalid API key.
- `422`: Invalid pagination params.

---

[API](https://skmtc.dev/unitpost/apis/unitpost-api.md) · [All operations](https://skmtc.dev/unitpost/apis/unitpost-api/llms.txt) · [OpenAPI document](https://skmtc.dev/unitpost/apis/unitpost-api/revisions/86ff7c890967?raw)