---
title: "List message templates"
method: GET
path: "/message_templates"
tags: ["Message Templates"]
---

# List message templates

`GET /message_templates`

List the message templates.

Required scope: `message_templates:read`

## Query parameters

- `sort_by` string
- `sort_order` 'asc' | 'desc'

## Response `200`

Array of message templates

- object
  - `_pagination` object
    - `next` string, nullable — Link to next [page of results](https://dev.frontapp.com/docs/pagination)
  - `_links` object
    - `self` string — Link to resource
  - `_results` MessageTemplateResponse[]
    - `_links` object, required
      - `self` string — Link to resource
      - `related` object
        - `owner` string, nullable — Link to resource's owner
        - `parent_folder` string, nullable — Link to the parent folder that contains the message template
    - `id` string, required — Unique identifier of the message template
    - `name` string, required — Name of the message template
    - `subject` string, nullable, required — Subject of the message template
    - `body` string, required — Body of the message template
    - `attachments` Attachment[], required — List of files attached to the response
      - `id` string, required — The unique identifier of the attachment.
      - `filename` string, required — Name of the attached file
      - `url` string, required — URL to download the attached file
      - `content_type` string, required — Content type of the attached file in [MIME format](https://developer.mozilla.org/en-US/docs/Web/HTTP/Basics_of_HTTP/MIME_types/Common_types). Note that some attachments types may not be supported.
      - `size` integer, required — Size (in byte) of the attached file
      - `metadata` object, required — Attachment metadata
        - `is_inline` boolean — Whether or not the attachment is part of the message body
        - `cid` string — Unique identifier used to link an attachment to where it is used in the message body
    - `is_available_for_all_inboxes` boolean, required — Whether or not the template is available in all inboxes.
    - `inbox_ids` string[], nullable, required — List of inboxes the template is available in. Null if there are no restrictions.

---

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