---
updatedAt: 2026-05-28T15:48:11.000Z
agentTools:
  projectIndex: https://dev.frontapp.com/llms.txt
---

# List teammate message templates

List the message templates belonging to the requested teammate.

Required scope: `message_templates:read`

# OpenAPI definition

```json
{
  "openapi": "3.0.0",
  "x-api-id": "front",
  "x-explorer-enabled": false,
  "x-proxy-enabled": true,
  "x-samples-enabled": true,
  "info": {
    "version": "1.0.0",
    "title": "Core API",
    "contact": {
      "name": "Front Platform",
      "url": "https://community.front.com"
    }
  },
  "security": [
    {
      "http": []
    }
  ],
  "servers": [
    {
      "url": "https://api2.frontapp.com"
    }
  ],
  "components": {
    "schemas": {
      "Attachment": {
        "type": "object",
        "required": [
          "id",
          "url",
          "filename",
          "content_type",
          "size",
          "metadata"
        ],
        "properties": {
          "id": {
            "type": "string",
            "description": "The unique identifier of the attachment.",
            "example": "fil_3q8a7mby"
          },
          "filename": {
            "type": "string",
            "description": "Name of the attached file",
            "example": "Andy_Anger_Management_Certificate.png"
          },
          "url": {
            "type": "string",
            "description": "URL to download the attached file",
            "example": "https://yourCompany.api.frontapp.com/download/fil_3q8a7mby"
          },
          "content_type": {
            "type": "string",
            "description": "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.",
            "example": "image/png"
          },
          "size": {
            "type": "integer",
            "description": "Size (in byte) of the attached file",
            "example": 4405
          },
          "metadata": {
            "description": "Attachment metadata",
            "type": "object",
            "properties": {
              "is_inline": {
                "type": "boolean",
                "description": "Whether or not the attachment is part of the message body",
                "example": true
              },
              "cid": {
                "type": "string",
                "description": "Unique identifier used to link an attachment to where it is used in the message body",
                "example": "526b45586d0e6b1c484afab63d1ef0be"
              }
            }
          }
        }
      },
      "MessageTemplateResponse": {
        "type": "object",
        "required": [
          "_links",
          "id",
          "name",
          "subject",
          "body",
          "attachments",
          "is_available_for_all_inboxes",
          "inbox_ids"
        ],
        "properties": {
          "_links": {
            "type": "object",
            "properties": {
              "self": {
                "type": "string",
                "description": "Link to resource",
                "example": "https://yourCompany.api.frontapp.com/responses/rsp_16yc"
              },
              "related": {
                "type": "object",
                "properties": {
                  "owner": {
                    "type": "string",
                    "nullable": true,
                    "description": "Link to resource's owner",
                    "example": "https://yourCompany.api.frontapp.com/teams/tim_s47"
                  },
                  "parent_folder": {
                    "nullable": true,
                    "type": "string",
                    "description": "Link to the parent folder that contains the message template",
                    "example": "https://yourCompany.api.frontapp.com/message_template_folders/rsf_g2"
                  }
                }
              }
            }
          },
          "id": {
            "type": "string",
            "description": "Unique identifier of the message template",
            "example": "rsp_16yc"
          },
          "name": {
            "type": "string",
            "description": "Name of the message template",
            "example": "Pam wedding planning complaint"
          },
          "subject": {
            "type": "string",
            "nullable": true,
            "description": "Subject of the message template",
            "example": "Work time being used for wedding planning"
          },
          "body": {
            "type": "string",
            "description": "Body of the message template",
            "example": "<div><p>Pam is spending time planning her <span style=\"color:red;\">wedding</span> at the office. This message <b>WAS NOT</b> sent by Angela.</p></div>\n"
          },
          "attachments": {
            "type": "array",
            "description": "List of files attached to the response",
            "items": {
              "$ref": "#/components/schemas/Attachment"
            }
          },
          "is_available_for_all_inboxes": {
            "type": "boolean",
            "description": "Whether or not the template is available in all inboxes.",
            "example": true
          },
          "inbox_ids": {
            "type": "array",
            "nullable": true,
            "description": "List of inboxes the template is available in. Null if there are no restrictions.",
            "items": {
              "type": "string",
              "example": null
            }
          }
        }
      }
    },
    "securitySchemes": {
      "http": {
        "type": "http",
        "scheme": "bearer",
        "bearerFormat": "JWT"
      }
    },
    "parameters": {
      "sortByCannedAnswers": {
        "name": "sort_by",
        "in": "query",
        "description": "Field used to sort the message templates. Either `created_at`, `updated_at`, or `sort_order`.",
        "schema": {
          "type": "string"
        }
      },
      "sortOrder": {
        "name": "sort_order",
        "in": "query",
        "description": "Order by which results should be sorted",
        "schema": {
          "type": "string",
          "enum": [
            "asc",
            "desc"
          ],
          "example": "asc"
        }
      }
    },
    "responses": {
      "listOfCannedAnswers": {
        "description": "Array of message templates",
        "content": {
          "application/json": {
            "schema": {
              "type": "object",
              "properties": {
                "_pagination": {
                  "type": "object",
                  "properties": {
                    "next": {
                      "type": "string",
                      "nullable": true,
                      "description": "Link to next [page of results](https://dev.frontapp.com/docs/pagination)",
                      "example": "https://yourCompany.api.frontapp.com/message_templates?page_token=9fa92a7f385fd7be43f7153055b30e6d"
                    }
                  }
                },
                "_links": {
                  "type": "object",
                  "properties": {
                    "self": {
                      "type": "string",
                      "description": "Link to resource",
                      "example": "https://yourCompany.api.frontapp.com/message_templates"
                    }
                  }
                },
                "_results": {
                  "type": "array",
                  "items": {
                    "$ref": "#/components/schemas/MessageTemplateResponse"
                  }
                }
              }
            }
          }
        }
      }
    }
  },
  "paths": {
    "/teammates/{teammate_id}/message_templates": {
      "get": {
        "summary": "List teammate message templates",
        "operationId": "list-teammate-message-templates",
        "description": "List the message templates belonging to the requested teammate.\n\nRequired scope: `message_templates:read`",
        "tags": [
          "Message Templates"
        ],
        "parameters": [
          {
            "in": "path",
            "name": "teammate_id",
            "required": true,
            "description": "The teammate ID. Alternatively, you can supply an email as a [resource alias](https://dev.frontapp.com/docs/resource-aliases-1).",
            "schema": {
              "type": "string",
              "default": "tea_123"
            }
          },
          {
            "$ref": "#/components/parameters/sortByCannedAnswers"
          },
          {
            "$ref": "#/components/parameters/sortOrder"
          }
        ],
        "responses": {
          "200": {
            "$ref": "#/components/responses/listOfCannedAnswers"
          }
        },
        "x-required-scopes": [
          "message_templates:read"
        ]
      }
    }
  }
}
```