---
title: "Retrieve a template"
method: GET
path: "/email/templates/{id}"
tags: ["Templates"]
---

# Retrieve a template

`GET /email/templates/{id}`

## Request

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

Retrieve a single template by `id`, including `html` (which [List templates](#get-email-templates) omits). Use this to read the body, then save changes with [Update a template](#patch-email-templates-id). Requires the `templates:read` capability.

## Response `200`

The template.

- Template
  - `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.
- `404`: Template not found.

---

[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)