---
title: "Adds message template"
method: POST
path: "/v1/templates"
tags: ["templates"]
---

# Adds message template

`POST /v1/templates`

## Request body

- MessageTemplateRequest
  - `name` string, required — message template name
  - `content` string, required — message template content
  - `sender` string — sender
  - `deliveryReport` boolean, required — request delivery report?
  - `remoteSmsShortcut` string — remote SMS shortcut
  - `smsType` integer — SMS type (0 = default, 1 = flash, 2 = both)
  - `contentCategory` string — content category (personal, advertisement or informational
  - `messageType` string — message type (default, voice, whatsapp, rcs
  - `urlshorteningType` string — urlshortening type
  - `pinned` boolean — pinned?
  - `templateCategoryId` integer — template category id
  - `preselectedCustomerChannelId` integer — preselected customer channel id
  - `rcsMessage` RcsMessage
    - `agentMessage` AgentContentMessageDto, required
      - `text` string
      - `fileName` string
      - `richCard` RichCardDto
        - `carouselCard` CarouselCardDto
          - `cardWidth` string
          - `cardContents` CardContentDto[]
            - `title` string
            - `description` string
            - `media` MediaDto
              - …
            - `suggestions` SuggestionDto[]
              - …
        - `standaloneCard` StandaloneCardDto
          - `cardOrientation` string
          - `thumbnailImageAlignment` string
          - `cardContent` CardContentDto
            - `title` string
            - `description` string
            - `media` MediaDto
              - …
            - `suggestions` SuggestionDto[]
              - …
      - `suggestions` SuggestionDto[]
        - `reply` ReplyDto
          - `text` string
          - `postbackData` string
        - `action` ActionDto
          - `text` string
          - `postbackData` string
          - `dialAction` DialActionDto
            - `phoneNumber` string
          - `viewLocationAction` ViewLocationActionDto
            - `latLong` LatLngDto, required
              - …
            - `label` string
            - `query` string
          - `createCalendarEventAction` CreateCalendarEventActionDto
            - `startTime` string
            - `endTime` string
            - `title` string
            - `description` string
          - `openUrlAction` OpenUrlActionDto
            - `application` string
            - `url` string
            - `description` string
            - `webviewViewMode` string
          - `shareLocationAction` ShareLocationActionDto
          - `composeAction` ComposeActionDto
            - `composeTextMessage` ComposeTextMessageDto
              - …
            - `composeRecordingMessage` ComposeRecordingMessageDto
              - …
      - `contentInfo` ContentInfoDto
        - `fileUrl` string
        - `thumbnailUrl` string
        - `forceRefresh` boolean

## Response `201`

Created

- MessageTemplateResponse
  - `name` string, required — message template name
  - `content` string, required — message template content
  - `sender` string — sender
  - `deliveryReport` boolean, required — request delivery report?
  - `remoteSmsShortcut` string — remote SMS shortcut
  - `smsType` integer — SMS type (0 = default, 1 = flash, 2 = both)
  - `contentCategory` string — content category (personal, advertisement or informational
  - `messageType` string — message type (default, voice, whatsapp, rcs
  - `urlshorteningType` string — urlshortening type
  - `pinned` boolean — pinned?
  - `templateCategoryId` integer — template category id
  - `preselectedCustomerChannelId` integer — preselected customer channel id
  - `rcsMessage` RcsMessage
    - `agentMessage` AgentContentMessageDto, required
      - `text` string
      - `fileName` string
      - `richCard` RichCardDto
        - `carouselCard` CarouselCardDto
          - `cardWidth` string
          - `cardContents` CardContentDto[]
            - `title` string
            - `description` string
            - `media` MediaDto
              - …
            - `suggestions` SuggestionDto[]
              - …
        - `standaloneCard` StandaloneCardDto
          - `cardOrientation` string
          - `thumbnailImageAlignment` string
          - `cardContent` CardContentDto
            - `title` string
            - `description` string
            - `media` MediaDto
              - …
            - `suggestions` SuggestionDto[]
              - …
      - `suggestions` SuggestionDto[]
        - `reply` ReplyDto
          - `text` string
          - `postbackData` string
        - `action` ActionDto
          - `text` string
          - `postbackData` string
          - `dialAction` DialActionDto
            - `phoneNumber` string
          - `viewLocationAction` ViewLocationActionDto
            - `latLong` LatLngDto, required
              - …
            - `label` string
            - `query` string
          - `createCalendarEventAction` CreateCalendarEventActionDto
            - `startTime` string
            - `endTime` string
            - `title` string
            - `description` string
          - `openUrlAction` OpenUrlActionDto
            - `application` string
            - `url` string
            - `description` string
            - `webviewViewMode` string
          - `shareLocationAction` ShareLocationActionDto
          - `composeAction` ComposeActionDto
            - `composeTextMessage` ComposeTextMessageDto
              - …
            - `composeRecordingMessage` ComposeRecordingMessageDto
              - …
      - `contentInfo` ContentInfoDto
        - `fileUrl` string
        - `thumbnailUrl` string
        - `forceRefresh` boolean
  - `id` integer, required — message template id
  - `lastModified` string, date-time — last modified
  - `lastModifiedBy` string — last modified by
  - `usageCounter` integer — usage counter
  - `links` Link[] — links
    - `rel` string
    - `href` string

## Other responses

- `500` — Internal server error

---

[API](https://skmtc.dev/linkmobility/apis/untitled-api.md) · [All operations](https://skmtc.dev/linkmobility/apis/untitled-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/linkmobility/untitled-api/revisions/db84f79799b9/schema)