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

# List email templates

`GET /v4/email_templates`

Returns a cursor-paginated list of the account's email templates with each template's `id`, `name`, `is_default` flag, and `category` (for example `HTML` or `Starting point`).

Use a template's `id` as the `email_template_id` when creating or updating a broadcast. **Note:** templates in the `Starting point` category are generally not supported when creating broadcasts via the API — using one returns a `Starting point email template is not supported` error unless your app has been enabled for it. See [Create a broadcast](/api-reference/broadcasts/create-a-broadcast).

## Query parameters

- `after` unknown
- `before` unknown
- `include_total_count` boolean
- `per_page` unknown

## Response `200`

Returns a paginated list of all email templates for your account

- object
  - `email_templates` object[], required
    - `id` integer, required
    - `name` string, required
    - `is_default` boolean, required
    - `category` string, required
  - `pagination` object, required
    - `has_previous_page` boolean, required
    - `has_next_page` boolean, required
    - `start_cursor` string, required
    - `end_cursor` string, required
    - `per_page` integer, required

## Other responses

- `401` — Returns a 401 if the token and/or account cannot be authenticated

---

[API](https://skmtc.net/kit/apis/kit-api.md) · [All operations](https://skmtc.net/kit/apis/kit-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/kit/kit-api/revisions/0df0c90d12da/schema)