---
title: "List email block types"
method: GET
path: "/email-blocks"
tags: ["Email Blocks"]
---

# List email block types

`GET /email-blocks`

Lists every block type accepted by the `blocks` array on campaigns, sequence email steps, templates, transactional emails, and email components, with the required and optional fields of each. Derived from the same schemas that validate a write, so it cannot drift from what those endpoints accept.

## Query parameters

- `creatableOnly` 'true'

## Response `200`

Block types listed

- object
  - `success` boolean
  - `blockTypes` EmailBlockTypeReference[]
    - `type` string
    - `creatable` boolean — False for structural types the editor manages, which should not be hand-authored.
    - `reason` string — Why a non-creatable type is excluded.
    - `required` string[]
    - `optional` string[]
    - `fields` EmailBlockFieldReference[]
      - `name` string
      - `required` boolean
      - `type` string — Value shape, for example string, number, boolean, enum, array, or object.
      - `values` unknown[] — Allowed values, for enum and literal-union fields.
        - unknown
      - `itemFields` EmailBlockFieldReference[] — Shape of one entry in an array field. This is where `list` and `steps` differ: list items carry `content`, steps items carry `title` and an optional `description`.
    - `example` object — A minimal valid block of this type.
    - `notes` string[]

## Other responses

- `401` — Unauthorized
- `503` — The database was temporarily unavailable. The request may be retried after the delay in Retry-After.

---

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