---
title: "Create User Message Template"
method: POST
path: "/restapi/v1.0/account/{accountId}/extension/{extensionId}/message-store-templates"
tags: ["SMS Templates"]
---

# Create User Message Template

`POST /restapi/v1.0/account/{accountId}/extension/{extensionId}/message-store-templates`

## Request

- Base URL: `https://platform.ringcentral.com`
- URL: `https://platform.ringcentral.com/restapi/v1.0/account/{accountId}/extension/{extensionId}/message-store-templates`
- Auth: OAuth 2
  - Authorization code: `https://platform.ringcentral.com/restapi/oauth/authorize`
  - Token URL: `https://platform.ringcentral.com/restapi/oauth/token`
- TypeScript: <https://skmtc.dev/ringcentral/apis/ringcentral-api/docs/restapi/v1.0/account/:accountId/extension/:extensionId/message-store-templates/post.ts> (a function with typed inputs; its response is checked against the schema)

Creates a user personal text message template. 
Maximum number of personal templates is 25 per user. 
Max length of the `body` property is 1000 symbols (2-byte UTF-16 encoded).

## Path parameters

- `accountId` string, required
- `extensionId` string, required

## Request body

- MessageTemplateRequest
  - `displayName` string, required: Name of a template
  - `body` TemplateInfo: Text message template information
    - `text` string, required: Text of the message template. Maximum length is 1000 symbols (2-byte UTF-16 encoded). If a character is encoded in 4 bytes in UTF-16 it is treated as 2 characters, thus limiting the maximum message length up to 500 symbols
  - `site` Site: Specifies a site that message template is associated with. Supported only if the Sites feature is enabled. The default is `main-site` value.
    - `id` string: Internal identifier of a site
    - `name` string: Custom name of a site

## Response `201`

Created personal text message template

- MessageTemplateResponse
  - `id` string: Internal identifier of a template
  - `displayName` string: Name of a template
  - `body` TemplateInfo: Text message template information
    - `text` string, required: Text of the message template. Maximum length is 1000 symbols (2-byte UTF-16 encoded). If a character is encoded in 4 bytes in UTF-16 it is treated as 2 characters, thus limiting the maximum message length up to 500 symbols
  - `scope` 'Company' | 'Personal': Specifies if a template is available on a user (Personal) or a company (Company) level
  - `site` Site: Specifies a site that message template is associated with. Supported only if the Sites feature is enabled. The default is `main-site` value.
    - `id` string: Internal identifier of a site
    - `name` string: Custom name of a site

## Other responses

- `400`: General response with **HTTP 400 "Bad request"** status.<br> Reasons: unparsable request, path, query or body parameters are invalid. The error description may contain reference to particular parameter(s) which haven't passed the validation.
- `404`: General response with **HTTP 404 "Not found"** status.<br> Reasons: the entity with given ID (typically specified in a path parameter), is not found or inaccessible

---

[API](https://skmtc.dev/ringcentral/apis/ringcentral-api.md) - [All operations](https://skmtc.dev/ringcentral/apis/ringcentral-api/llms.txt) - [OpenAPI document](https://skmtc.dev/ringcentral/apis/ringcentral-api/revisions/8d602198ec97?raw)