---
title: "Create message template"
method: POST
path: "/message_templates"
tags: ["Message Templates"]
---

# Create message template

`POST /message_templates`

Create a new message template in the oldest active workspace that the token has access to. If you need to specify the workspace, we recommend using the [Create team message template](https://dev.frontapp.com/reference/create-team-message-template) endpoint instead.

Required scope: `message_templates:write`

## Request body

- CreateSharedMessageTemplate — A message template that is used for pre-written responses
  - `name` string, required — Name of the message template
  - `subject` string — Subject of the message template.
  - `body` string, required — Body of the message template. You can supply HTML with inline CSS to structure and style your template.
  - `folder_id` string — ID of the message template folder to place this message template in
  - `inbox_ids` string[] — The specific inboxes this template is available in. If unspecified or null, then it will be available in all inboxes. Array should be non-empty.
  - `attachments` string[] — Binary data of attached files. Must use `Content-Type: multipart/form-data` if specified. See [example](https://dev.frontapp.com/docs/attachments-1). Max 25 MB.

## Response `201`

A message template

- 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)