Skip to content

Templates API

List templates

GEThttps://email.growthdept.ai/api/templates

Templates in the account's library, a page at a time. additional-fields[template]=definition adds drag-and-drop documents.

Sort by created, id, name, updated, ascending or descending (put - in front).

Ask for definition with additional-fields[template]; they are left out unless you do.

Rate limits

Burst: 75/s

Steady: 750/m

Tier L. See rate limits for how requests are counted.

Scopes

templates:read

Operation id

get_templates The same operation as in Klaviyo's API. OpenAPI document

Query parameters

array of strings

Attributes left out unless asked for.

Additional fields guide

Pick values to add them to the request:

array of strings

Attributes of template resources to return.

Sparse fieldsets guide

Pick values to add them to the request:

string

Filter expression.

Filtering guide

Fields and the operators each one takes:

  • id: equals, any
  • name: equals, any, contains
  • created: equals, greater-than, greater-or-equal, less-than, less-or-equal
  • updated: equals, greater-than, greater-or-equal, less-than, less-or-equal

string

From links.next or links.prev of the previous page.

Pagination guide

integer1 to 10default 10

Default 10, at most 10.

Pagination guide

string

Default id.

Sorting guide

Headers

stringrequireddefault 2026-10-15

API revision, YYYY-MM-DD. This server implements 2026-10-15.

Revisions guide

Responses

200Success

Response body

object

  • dataarray of objectsrequired

    data: 4 fields
    • typestringrequired

      template
    • attributesobjectrequired

      attributes: 9 fields
      • definitionobjectcan be null

        definition: 4 fields
        • idstringcan be null

        • template_idstringcan be null

        • bodyobjectrequired

          body: 4 fields
          • idstringcan be null

          • propertiesobjectrequired

            properties: 2 fields
            • idstringcan be null

            • css_classstringcan be null

          • stylesobjectrequired

            styles: 2 fields
            • background_colorstringcan be null

            • widthintegercan be null

          • sectionsarray of objectscan be null

            sections: 7 fields
            • idstringcan be null

            • data_idstringcan be null

            • universal_idstringcan be null

            • content_typestringrequired

              section
            • typestringrequired

              section
            • dataobjectrequired

              data: 3 fields
              • propertiesobjectrequired

              • display_optionsobjectrequired

              • stylesobjectrequired

            • rowsarray of objectscan be null

              rows: 4 fields
              • idstringcan be null

              • data_idstringcan be null

              • dataobjectrequired

              • columnsarray of objectscan be null

        • stylesarray of objectsrequired

          One option: BaseStyle
          • idstringcan be null

          • style_typestringrequired

            base-styles
          • propertiesobjectrequired

            properties: 6 fields
            • currencystringcan be null

            • currency_set_on_templatebooleancan be null

            • disable_websafe_fontsbooleancan be null

            • is_user_draggablebooleancan be null

            • mobile_optimizationsbooleancan be null

            • tip_tap_enabledbooleancan be null

          • stylesobjectrequired

            styles: 15 fields
            • background_asset_idstringcan be null

            • background_formatstringcan be null

              autocontaincoverinitialrepeat
            • background_positionstringcan be null

              center-bottomcenter-centercenter-topleft-bottomleft-centerleft-topright-bottomright-centerright-top
            • background_repeatbooleancan be null

            • background_urlstringcan be null

            • border_colorstringcan be null

            • border_radiusintegercan be null

            • border_stylestringcan be null

              dasheddottedgrooveinsetnoneoutsetridgesolid
            • border_widthintegercan be null

            • content_background_colorstringcan be null

            • inner_padding_bottomintegercan be null

            • inner_padding_leftintegercan be null

            • inner_padding_rightintegercan be null

            • inner_padding_topintegercan be null

            • margin_topintegercan be null

          One option: TextStyleV1
          • idstringcan be null

          • style_typestringrequired

            text-styles
          • stylesobjectrequired

            styles: 11 fields
            • colorstringcan be null

            • font_familystringcan be null

            • font_sizeintegercan be null

            • font_stylestringcan be null

              italicnormal
            • font_weightstringcan be null

            • letter_spacingintegercan be null

            • line_heightnumbercan be null

            • mobile_font_sizeintegercan be null

            • mobile_line_heightnumbercan be null

            • text_alignstringcan be null

              centerleftright
            • text_decorationstringcan be null

          One option: Heading1Style
          • idstringcan be null

          • style_typestringrequired

            heading-1-styles
          • stylesobjectrequired

            styles: 12 fields
            • colorstringcan be null

            • font_familystringcan be null

            • font_sizeintegercan be null

            • font_stylestringcan be null

              italicnormal
            • font_weightstringcan be null

            • letter_spacingintegercan be null

            • line_heightnumbercan be null

            • margin_bottomintegercan be null

            • mobile_font_sizeintegercan be null

            • mobile_line_heightnumbercan be null

            • text_alignstringcan be null

              centerleftright
            • text_decorationstringcan be null

          One option: Heading2Style
          • idstringcan be null

          • style_typestringrequired

            heading-2-styles
          • stylesobjectrequired

            styles: 12 fields
            • colorstringcan be null

            • font_familystringcan be null

            • font_sizeintegercan be null

            • font_stylestringcan be null

              italicnormal
            • font_weightstringcan be null

            • letter_spacingintegercan be null

            • line_heightnumbercan be null

            • margin_bottomintegercan be null

            • mobile_font_sizeintegercan be null

            • mobile_line_heightnumbercan be null

            • text_alignstringcan be null

              centerleftright
            • text_decorationstringcan be null

          One option: Heading3Style
          • idstringcan be null

          • style_typestringrequired

            heading-3-styles
          • stylesobjectrequired

            styles: 12 fields
            • colorstringcan be null

            • font_familystringcan be null

            • font_sizeintegercan be null

            • font_stylestringcan be null

              italicnormal
            • font_weightstringcan be null

            • letter_spacingintegercan be null

            • line_heightnumbercan be null

            • margin_bottomintegercan be null

            • mobile_font_sizeintegercan be null

            • mobile_line_heightnumbercan be null

            • text_alignstringcan be null

              centerleftright
            • text_decorationstringcan be null

          One option: Heading4Style
          • idstringcan be null

          • style_typestringrequired

            heading-4-styles
          • stylesobjectrequired

            styles: 12 fields
            • colorstringcan be null

            • font_familystringcan be null

            • font_sizeintegercan be null

            • font_stylestringcan be null

              italicnormal
            • font_weightstringcan be null

            • letter_spacingintegercan be null

            • line_heightnumbercan be null

            • margin_bottomintegercan be null

            • mobile_font_sizeintegercan be null

            • mobile_line_heightnumbercan be null

            • text_alignstringcan be null

              centerleftright
            • text_decorationstringcan be null

          One option: LinkStyle
          • idstringcan be null

          • style_typestringrequired

            link-styles
          • stylesobjectrequired

            styles: 4 fields
            • colorstringcan be null

            • font_stylestringcan be null

              italicnormal
            • font_weightstringcan be null

            • text_decorationstringcan be null

          One option: MobileStyle
          • idstringcan be null

          • style_typestringrequired

            mobile-styles
          • propertiesobjectrequired

            properties: 1 field
            • mobile_padding_overridebooleancan be null

          • stylesobjectrequired

            styles: 7 fields
            • mobile_block_padding_leftintegercan be null

            • mobile_block_padding_rightintegercan be null

            • mobile_marginintegercan be null

            • mobile_padding_bottomintegercan be null

            • mobile_padding_leftintegercan be null

            • mobile_padding_rightintegercan be null

            • mobile_padding_topintegercan be null

      • namestringrequired

      • editor_typestringrequired

      • htmlstringrequired

      • textstringcan be null

      • ampstringcan be null

      • createdstring (date-time)can be null

      • updatedstring (date-time)can be null

      • screenshot_urlstringcan be null

    • idstringrequired

    • linksobjectrequired

      links: 1 field
      • selfstring (uri)required

  • linksobject

    links: 3 fields
    • selfstring (uri)required

    • prevstring (uri)

    • nextstring (uri)

  • metaobject

4XXClient error

Response body

object

  • errorsarray of objectsrequired

    errors: 8 fields
    • idstringrequired

    • statusintegerrequired

    • codestringrequired

    • titlestringrequired

    • detailstringrequired

    • sourceobject

      source: 2 fields
      • pointerstring

      • parameterstring

    • linksobject

    • metaobject

See status codes for each code.

5XXServer error

Response body

object

  • errorsarray of objectsrequired

    errors: 8 fields
    • idstringrequired

    • statusintegerrequired

    • codestringrequired

    • titlestringrequired

    • detailstringrequired

    • sourceobject

      source: 2 fields
      • pointerstring

      • parameterstring

    • linksobject

    • metaobject