---
title: "Create Template"
method: POST
path: "/v1/templates"
tags: ["Templates"]
---

# Create Template

`POST /v1/templates`

## Request body

- TemplatePostRequestWrapperDto
  - `data` union, required
    - TemplateSMSPostRequestDto
      - `channel` string, required — Template channel. Enumeration values [SMS, VIBER, WHATSAPP]
      - `name` string — Name (unique identifier) of the template
      - `text` string, required — Text of the template may contain variables. Maximum 1000 characters. If you want to include a URL and have it shortened (with analytics tracking), wrap it in curly braces using the following format: {url=https://dexatel.com}.
    - union
      - object
        - `channel` 'VIBER', required — Template channel. Enumeration values [SMS, VIBER, WHATSAPP]
        - `viber_category` 'PROMOTIONAL' | 'TRANSACTIONAL' | 'OTP', required — Viber template category. Required. Enumeration values [PROMOTIONAL, TRANSACTIONAL, OTP]. For OTP and TRANSACTIONAL, viber_template is required and type must be TEXT. For PROMOTIONAL, viber_template must not be provided.
        - `viber_template` object — Viber OTP/Transactional template details. Required when viber_category is OTP or TRANSACTIONAL. Must not be provided when viber_category is PROMOTIONAL.
          - `sender_code` string — Viber sender code. Required for OTP and Transactional templates
          - `params` ViberTemplateParamDto[] — Template parameter definitions. Maximum 5 parameters. For OTP category, must have exactly one item with name 'code'. For TRANSACTIONAL, can be an empty list.
            - `name` string — Parameter name. Must contain only English letters, digits, and underscores. Maximum 50 characters
            - `type` 'TEXT' — Parameter type. Must be TEXT
          - `locales` ViberTemplateLocaleDto[] — Template locale entries. Must contain exactly one locale
            - `lang` string — Language code. Must be one of the supported language codes
            - `template` string — Template body text. Must be between 1 and 875 characters. Must start and end with static text, not a placeholder. Must not contain consecutive placeholders. Must contain a placeholder for every defined param
          - `var_example` ViberTemplateVarExampleDto[] — Example values for template variables. Maximum 5 entries. For OTP category, must have exactly one item with name 'code'. For TRANSACTIONAL, can be an empty list.
            - `name` string — Variable name. Must match a defined parameter name. Maximum 50 characters
            - `example` string — Example value for the variable. Must not contain a URL, link, or email address. Maximum 100 characters
        - `type` string, required — Template type. Enumeration values [text, image, video, document, carousel, survey]
        - `name` string — Name (unique identifier) of the template. Maximum 45 characters. Only letters, numbers, and (- _) are allowed
        - `text` string, required — Text of the template may contain variables. Maximum 1000 characters
        - `button_text` string — When 'button_text' is provided 'button_value' is required
        - `button_value` string — When 'button_value' is provided 'button_text' is required
      - object
        - `channel` 'VIBER', required — Template channel. Enumeration values [SMS, VIBER, WHATSAPP]
        - `viber_category` 'PROMOTIONAL' | 'TRANSACTIONAL' | 'OTP', required — Viber template category. Required. Enumeration values [PROMOTIONAL, TRANSACTIONAL, OTP]. For OTP and TRANSACTIONAL, viber_template is required and type must be TEXT. For PROMOTIONAL, viber_template must not be provided.
        - `viber_template` object — Viber OTP/Transactional template details. Required when viber_category is OTP or TRANSACTIONAL. Must not be provided when viber_category is PROMOTIONAL.
          - `sender_code` string — Viber sender code. Required for OTP and Transactional templates
          - `params` ViberTemplateParamDto[] — Template parameter definitions. Maximum 5 parameters. For OTP category, must have exactly one item with name 'code'. For TRANSACTIONAL, can be an empty list.
            - `name` string — Parameter name. Must contain only English letters, digits, and underscores. Maximum 50 characters
            - `type` 'TEXT' — Parameter type. Must be TEXT
          - `locales` ViberTemplateLocaleDto[] — Template locale entries. Must contain exactly one locale
            - `lang` string — Language code. Must be one of the supported language codes
            - `template` string — Template body text. Must be between 1 and 875 characters. Must start and end with static text, not a placeholder. Must not contain consecutive placeholders. Must contain a placeholder for every defined param
          - `var_example` ViberTemplateVarExampleDto[] — Example values for template variables. Maximum 5 entries. For OTP category, must have exactly one item with name 'code'. For TRANSACTIONAL, can be an empty list.
            - `name` string — Variable name. Must match a defined parameter name. Maximum 50 characters
            - `example` string — Example value for the variable. Must not contain a URL, link, or email address. Maximum 100 characters
        - `type` string, required — Template type. Enumeration values [text, image, video, document, carousel, survey]
        - `name` string — Name (unique identifier) of the template. Maximum 45 characters. Only letters, numbers, and (- _) are allowed
        - `text` string — Text of the template may contain variables. Maximum 1000 characters. If text is present, button_text and button_value are required
        - `url` string — One of 'url' or 'media_id' is required
        - `media_id` string, uuid — One of 'url' or 'media_id' is required
        - `button_text` string — When 'button_text' is provided 'button_value' is required
        - `button_value` string — When 'button_value' is provided 'button_text' is required
      - object
        - `channel` 'VIBER', required — Template channel. Enumeration values [SMS, VIBER, WHATSAPP]
        - `viber_category` 'PROMOTIONAL' | 'TRANSACTIONAL' | 'OTP', required — Viber template category. Required. Enumeration values [PROMOTIONAL, TRANSACTIONAL, OTP]. For OTP and TRANSACTIONAL, viber_template is required and type must be TEXT. For PROMOTIONAL, viber_template must not be provided.
        - `viber_template` object — Viber OTP/Transactional template details. Required when viber_category is OTP or TRANSACTIONAL. Must not be provided when viber_category is PROMOTIONAL.
          - `sender_code` string — Viber sender code. Required for OTP and Transactional templates
          - `params` ViberTemplateParamDto[] — Template parameter definitions. Maximum 5 parameters. For OTP category, must have exactly one item with name 'code'. For TRANSACTIONAL, can be an empty list.
            - `name` string — Parameter name. Must contain only English letters, digits, and underscores. Maximum 50 characters
            - `type` 'TEXT' — Parameter type. Must be TEXT
          - `locales` ViberTemplateLocaleDto[] — Template locale entries. Must contain exactly one locale
            - `lang` string — Language code. Must be one of the supported language codes
            - `template` string — Template body text. Must be between 1 and 875 characters. Must start and end with static text, not a placeholder. Must not contain consecutive placeholders. Must contain a placeholder for every defined param
          - `var_example` ViberTemplateVarExampleDto[] — Example values for template variables. Maximum 5 entries. For OTP category, must have exactly one item with name 'code'. For TRANSACTIONAL, can be an empty list.
            - `name` string — Variable name. Must match a defined parameter name. Maximum 50 characters
            - `example` string — Example value for the variable. Must not contain a URL, link, or email address. Maximum 100 characters
        - `type` string, required — Template type. Enumeration values [text, image, video, document, carousel, survey]
        - `name` string — Name (unique identifier) of the template. Maximum 45 characters. Only letters, numbers, and (- _) are allowed
        - `text` string — Text of the template may contain variables. Maximum 1000 characters
        - `url` string — One of 'url' or 'media_id' is required
        - `media_id` string, uuid — One of 'url' or 'media_id' is required
      - object
        - `channel` 'VIBER', required — Template channel. Enumeration values [SMS, VIBER, WHATSAPP]
        - `viber_category` 'PROMOTIONAL' | 'TRANSACTIONAL' | 'OTP', required — Viber template category. Required. Enumeration values [PROMOTIONAL, TRANSACTIONAL, OTP]. For OTP and TRANSACTIONAL, viber_template is required and type must be TEXT. For PROMOTIONAL, viber_template must not be provided.
        - `viber_template` object — Viber OTP/Transactional template details. Required when viber_category is OTP or TRANSACTIONAL. Must not be provided when viber_category is PROMOTIONAL.
          - `sender_code` string — Viber sender code. Required for OTP and Transactional templates
          - `params` ViberTemplateParamDto[] — Template parameter definitions. Maximum 5 parameters. For OTP category, must have exactly one item with name 'code'. For TRANSACTIONAL, can be an empty list.
            - `name` string — Parameter name. Must contain only English letters, digits, and underscores. Maximum 50 characters
            - `type` 'TEXT' — Parameter type. Must be TEXT
          - `locales` ViberTemplateLocaleDto[] — Template locale entries. Must contain exactly one locale
            - `lang` string — Language code. Must be one of the supported language codes
            - `template` string — Template body text. Must be between 1 and 875 characters. Must start and end with static text, not a placeholder. Must not contain consecutive placeholders. Must contain a placeholder for every defined param
          - `var_example` ViberTemplateVarExampleDto[] — Example values for template variables. Maximum 5 entries. For OTP category, must have exactly one item with name 'code'. For TRANSACTIONAL, can be an empty list.
            - `name` string — Variable name. Must match a defined parameter name. Maximum 50 characters
            - `example` string — Example value for the variable. Must not contain a URL, link, or email address. Maximum 100 characters
        - `type` string, required — Template type. Enumeration values [text, image, video, document, carousel, survey]
        - `name` string — Name (unique identifier) of the template. Maximum 45 characters. Only letters, numbers, and (- _) are allowed
        - `filename` string, required — Filename of the document. Maximum 25 characters which contains only [a-zA-Z0-9_]
        - `url` string — One of 'url' or 'media_id' is required
        - `media_id` string, uuid — One of 'url' or 'media_id' is required
      - object
        - `channel` 'VIBER', required — Template channel. Enumeration values [SMS, VIBER, WHATSAPP]
        - `viber_category` 'PROMOTIONAL' | 'TRANSACTIONAL' | 'OTP', required — Viber template category. Required. Enumeration values [PROMOTIONAL, TRANSACTIONAL, OTP]. For OTP and TRANSACTIONAL, viber_template is required and type must be TEXT. For PROMOTIONAL, viber_template must not be provided.
        - `viber_template` object — Viber OTP/Transactional template details. Required when viber_category is OTP or TRANSACTIONAL. Must not be provided when viber_category is PROMOTIONAL.
          - `sender_code` string — Viber sender code. Required for OTP and Transactional templates
          - `params` ViberTemplateParamDto[] — Template parameter definitions. Maximum 5 parameters. For OTP category, must have exactly one item with name 'code'. For TRANSACTIONAL, can be an empty list.
            - `name` string — Parameter name. Must contain only English letters, digits, and underscores. Maximum 50 characters
            - `type` 'TEXT' — Parameter type. Must be TEXT
          - `locales` ViberTemplateLocaleDto[] — Template locale entries. Must contain exactly one locale
            - `lang` string — Language code. Must be one of the supported language codes
            - `template` string — Template body text. Must be between 1 and 875 characters. Must start and end with static text, not a placeholder. Must not contain consecutive placeholders. Must contain a placeholder for every defined param
          - `var_example` ViberTemplateVarExampleDto[] — Example values for template variables. Maximum 5 entries. For OTP category, must have exactly one item with name 'code'. For TRANSACTIONAL, can be an empty list.
            - `name` string — Variable name. Must match a defined parameter name. Maximum 50 characters
            - `example` string — Example value for the variable. Must not contain a URL, link, or email address. Maximum 100 characters
        - `type` string, required — Template type. Enumeration values [text, image, video, document, carousel, survey]
        - `name` string — Name (unique identifier) of the template. Maximum 45 characters. Only letters, numbers, and (- _) are allowed
        - `text` string — Main title text of the carousel template. Maximum 1000 characters
        - `carousel_items` object[], required — Array of carousel items
          - `title` string, required — Title of the carousel item
          - `image_url` string, nullable — Image URL for the carousel item. One of 'image_url' or 'media_id' is required
          - `media_id` string, uuid — Media ID for the carousel item. One of 'image_url' or 'media_id' is required
          - `primary_button` object, required — Primary button of the carousel item
            - `label` string — Button label text
            - `action_url` string — URL to open when button is clicked
            - `inactive_viber_link` boolean — Whether Viber link is inactive
          - `secondary_button` object — Secondary button of the carousel item
            - `label` string — Button label text
            - `action_url` string — URL to open when button is clicked
      - object
        - `channel` 'VIBER', required — Template channel. Enumeration values [SMS, VIBER, WHATSAPP]
        - `viber_category` 'PROMOTIONAL' | 'TRANSACTIONAL' | 'OTP', required — Viber template category. Required. Enumeration values [PROMOTIONAL, TRANSACTIONAL, OTP]. For OTP and TRANSACTIONAL, viber_template is required and type must be TEXT. For PROMOTIONAL, viber_template must not be provided.
        - `viber_template` object — Viber OTP/Transactional template details. Required when viber_category is OTP or TRANSACTIONAL. Must not be provided when viber_category is PROMOTIONAL.
          - `sender_code` string — Viber sender code. Required for OTP and Transactional templates
          - `params` ViberTemplateParamDto[] — Template parameter definitions. Maximum 5 parameters. For OTP category, must have exactly one item with name 'code'. For TRANSACTIONAL, can be an empty list.
            - `name` string — Parameter name. Must contain only English letters, digits, and underscores. Maximum 50 characters
            - `type` 'TEXT' — Parameter type. Must be TEXT
          - `locales` ViberTemplateLocaleDto[] — Template locale entries. Must contain exactly one locale
            - `lang` string — Language code. Must be one of the supported language codes
            - `template` string — Template body text. Must be between 1 and 875 characters. Must start and end with static text, not a placeholder. Must not contain consecutive placeholders. Must contain a placeholder for every defined param
          - `var_example` ViberTemplateVarExampleDto[] — Example values for template variables. Maximum 5 entries. For OTP category, must have exactly one item with name 'code'. For TRANSACTIONAL, can be an empty list.
            - `name` string — Variable name. Must match a defined parameter name. Maximum 50 characters
            - `example` string — Example value for the variable. Must not contain a URL, link, or email address. Maximum 100 characters
        - `type` string, required — Template type. Enumeration values [text, image, video, document, carousel, survey]
        - `name` string — Name (unique identifier) of the template. Maximum 45 characters. Only letters, numbers, and (- _) are allowed
        - `text` string — Survey question text. Maximum 85 characters
        - `survey_options` string[], required — Array of survey option strings. Minimum 2, maximum 5 options
    - union
      - object
        - `channel` 'WHATSAPP', required — Template channel. Enumeration values [SMS, VIBER, WHATSAPP]
        - `type` string, required — Template type. Enumeration values [text, image, video, document]
        - `name` string, required — Name (unique identifier) of the template. Only lowercase letters, numbers, and (_) are allowed
        - `wa_category` 'MARKETING' | 'UTILITY', required — Different charging is applied based on Template Category
        - `wa_sender_code` string, required — Code (unique identifier) of the WhatsApp sender
        - `text` string, required — Text of the template may contain variables. Maximum 1000 characters
        - `button_type` 'QUICK_REPLY' | 'PHONE_CALL' | 'LINK' | 'CALL_TO_ACTION' | 'CALL_TO_ACTION_DYNAMIC' — WhatsApp button type. Valid button_value is required based on type. Use CALL_TO_ACTION for static URLs, CALL_TO_ACTION_DYNAMIC for URLs with a dynamic {path} placeholder.
        - `button_text` string — Required when 'button_type' is provided
        - `button_value` string — Required when 'button_type' is 'PHONE_CALL' or 'LINK'
        - `wa_text_examples` string[] — Example values for placeholders in the template text. Required by WhatsApp when the text contains variables.
        - `button_url_example` string — Required when 'button_type' is 'CALL_TO_ACTION' and 'button_value' contains a dynamic placeholder (e.g. https://example.com/{path}). Provides a concrete example value for the dynamic URL segment.
        - `otp_expiration_seconds` integer — OTP expiration time in seconds. Must be between 30 and 900. Defaults to 900 if not provided. Applicable for WhatsApp OTP templates.
      - object
        - `channel` 'WHATSAPP', required — Template channel. Enumeration values [SMS, VIBER, WHATSAPP]
        - `type` string, required — Template type. Enumeration values [text, image, video, document]
        - `name` string, required — Name (unique identifier) of the template. Only lowercase letters, numbers, and (_) are allowed
        - `wa_category` 'MARKETING' | 'UTILITY', required — Different charging is applied based on Template Category
        - `wa_sender_code` string, required — Code (unique identifier) of the WhatsApp sender
        - `text` string, required — Text of the template may contain variables. Maximum 1000 characters
        - `url` string — One of 'url' or 'media_id' is required
        - `media_id` string, uuid — One of 'url' or 'media_id' is required
        - `button_type` 'QUICK_REPLY' | 'PHONE_CALL' | 'LINK' | 'CALL_TO_ACTION' | 'CALL_TO_ACTION_DYNAMIC' — WhatsApp button type. Valid button_value is required based on type. Use CALL_TO_ACTION for static URLs, CALL_TO_ACTION_DYNAMIC for URLs with a dynamic {path} placeholder.
        - `button_text` string — Required when 'button_type' is provided
        - `button_value` string — Required when 'button_type' is 'PHONE_CALL' or 'LINK'
        - `wa_text_examples` string[] — Example values for placeholders in the template text. Required by WhatsApp when the text contains variables.
        - `button_url_example` string — Required when 'button_type' is 'CALL_TO_ACTION' and 'button_value' contains a dynamic placeholder (e.g. https://example.com/{path}). Provides a concrete example value for the dynamic URL segment.
        - `otp_expiration_seconds` integer — OTP expiration time in seconds. Must be between 30 and 900. Defaults to 900 if not provided. Applicable for WhatsApp OTP templates.
      - object
        - `channel` 'WHATSAPP', required — Template channel. Enumeration values [SMS, VIBER, WHATSAPP]
        - `type` string, required — Template type. Enumeration values [text, image, video, document]
        - `name` string, required — Name (unique identifier) of the template. Only lowercase letters, numbers, and (_) are allowed
        - `wa_category` 'MARKETING' | 'UTILITY', required — Different charging is applied based on Template Category
        - `wa_sender_code` string, required — Code (unique identifier) of the WhatsApp sender
        - `text` string, required — Text of the template may contain variables. Maximum 1000 characters
        - `url` string — One of 'url' or 'media_id' is required
        - `media_id` string, uuid — One of 'url' or 'media_id' is required
        - `button_type` 'QUICK_REPLY' | 'PHONE_CALL' | 'LINK' | 'CALL_TO_ACTION' | 'CALL_TO_ACTION_DYNAMIC' — WhatsApp button type. Valid button_value is required based on type. Use CALL_TO_ACTION for static URLs, CALL_TO_ACTION_DYNAMIC for URLs with a dynamic {path} placeholder.
        - `button_text` string — Required when 'button_type' is provided
        - `button_value` string — Required when 'button_type' is 'PHONE_CALL' or 'LINK'
        - `wa_text_examples` string[] — Example values for placeholders in the template text. Required by WhatsApp when the text contains variables.
        - `button_url_example` string — Required when 'button_type' is 'CALL_TO_ACTION' and 'button_value' contains a dynamic placeholder (e.g. https://example.com/{path}). Provides a concrete example value for the dynamic URL segment.
        - `otp_expiration_seconds` integer — OTP expiration time in seconds. Must be between 30 and 900. Defaults to 900 if not provided. Applicable for WhatsApp OTP templates.
      - object
        - `channel` 'WHATSAPP', required — Template channel. Enumeration values [SMS, VIBER, WHATSAPP]
        - `type` string, required — Template type. Enumeration values [text, image, video, document]
        - `name` string, required — Name (unique identifier) of the template. Only lowercase letters, numbers, and (_) are allowed
        - `wa_category` 'MARKETING' | 'UTILITY', required — Different charging is applied based on Template Category
        - `wa_sender_code` string, required — Code (unique identifier) of the WhatsApp sender
        - `text` string, required — Text of the template may contain variables. Maximum 1000 characters
        - `filename` string, required — Filename of the document. Maximum 25 characters which contains only [a-zA-Z0-9_]
        - `url` string — One of 'url' or 'media_id' is required
        - `media_id` string, uuid — One of 'url' or 'media_id' is required
        - `button_type` 'QUICK_REPLY' | 'PHONE_CALL' | 'LINK' | 'CALL_TO_ACTION' | 'CALL_TO_ACTION_DYNAMIC' — WhatsApp button type. Valid button_value is required based on type. Use CALL_TO_ACTION for static URLs, CALL_TO_ACTION_DYNAMIC for URLs with a dynamic {path} placeholder.
        - `button_text` string — Required when 'button_type' is provided
        - `button_value` string — Required when 'button_type' is 'PHONE_CALL' or 'LINK'
        - `wa_text_examples` string[] — Example values for placeholders in the template text. Required by WhatsApp when the text contains variables.
        - `button_url_example` string — Required when 'button_type' is 'CALL_TO_ACTION' and 'button_value' contains a dynamic placeholder (e.g. https://example.com/{path}). Provides a concrete example value for the dynamic URL segment.
        - `otp_expiration_seconds` integer — OTP expiration time in seconds. Must be between 30 and 900. Defaults to 900 if not provided. Applicable for WhatsApp OTP templates.

## Response `200`

OK

- TemplateResponseWrapperDto
  - `data` object
    - `id` string, uuid — Unique identifier of the template
    - `account_id` string, uuid — Unique identifier of the account
    - `name` string — Name (unique identifier) of the template
    - `text` string — Text of the template may contain variables. Maximum 1000 characters
    - `channel` 'SMS' | 'VIBER' | 'WHATSAPP' — Template channel. Enumeration values [SMS, VIBER, WHATSAPP]
    - `status` 'COMPLETED' | 'IN_PROCESS' | 'CANCELED' — Template status. Enumeration values [COMPLETED, IN_PROCESS, CANCELED]
    - `type` 'text' | 'image' | 'video' | 'document' | 'carousel' | 'survey' — Template type. Enumeration values [text, image, video, document, carousel, survey]
    - `url` string — Template media url for image,video or document types
    - `filename` string — Template filename for document type
    - `button_type` string — WhatsApp Template button type
    - `button_text` string — Template button text
    - `button_value` string — Template button value
    - `placeholder_count` integer — Indicates the number of attributes. Values wrapped in {}
    - `media_id` string, uuid — Template media id for image,video or document types
    - `carousel_items` object[] — Array of carousel items. Present when type is 'carousel'
      - `title` string — Title of the carousel item
      - `media_id` string, uuid — Media ID of the carousel item image
      - `image_url` string, nullable — Image URL of the carousel item
      - `primary_button` object — Primary button of the carousel item
        - `label` string — Button label text
        - `action_url` string — URL to open when button is clicked
        - `inactive_viber_link` boolean — Whether Viber link is inactive
      - `secondary_button` object — Secondary button of the carousel item
        - `label` string — Button label text
        - `action_url` string — URL to open when button is clicked
        - `inactive_viber_link` boolean — Whether Viber link is inactive
    - `survey_options` string[] — Array of survey option strings. Present when type is 'survey'. Minimum 2, maximum 5 options
    - `create_date` string, date-time — Creation date of the template in UTC, formatted as yyyy-mm-dd hh:mm:ss
    - `update_date` string, date-time — Update date of the template in UTC, formatted as yyyy-mm-dd hh:mm:ss
    - `viber_category` 'PROMOTIONAL' | 'TRANSACTIONAL' | 'OTP' — Viber template category. Enumeration values [PROMOTIONAL, TRANSACTIONAL, OTP]
    - `viber_template` object — Viber OTP/Transactional template details. Present when viber_category is OTP or TRANSACTIONAL
      - `template_id` string — Viber template ID assigned by the Viber service
      - `sender_code` string — Viber sender code
      - `status` string — Viber template registration status
      - `status_note` string — Additional status information
      - `category` string — Viber template category as returned by the Viber service
      - `service_id` integer — Viber service ID
      - `created_at` integer — Template creation timestamp (Unix epoch)
      - `params` ViberTemplateParamDto[] — Template parameter definitions
        - `name` string — Parameter name. Must contain only English letters, digits, and underscores. Maximum 50 characters
        - `type` 'TEXT' — Parameter type. Must be TEXT
      - `locales` ViberTemplateLocaleDto[] — Template locale entries
        - `lang` string — Language code. Must be one of the supported language codes
        - `template` string — Template body text. Must be between 1 and 875 characters. Must start and end with static text, not a placeholder. Must not contain consecutive placeholders. Must contain a placeholder for every defined param
      - `var_example` ViberTemplateVarExampleDto[] — Example values for template variables
        - `name` string — Variable name. Must match a defined parameter name. Maximum 50 characters
        - `example` string — Example value for the variable. Must not contain a URL, link, or email address. Maximum 100 characters
    - `wa_sender_code` string — WhatsApp sender code associated with the template
    - `wa_category` string — WhatsApp template category (e.g. MARKETING, UTILITY, AUTHENTICATION)
    - `wa_text_examples` string[] — Example values for placeholders in the template text
    - `button_url_example` string — Example value for the dynamic URL segment in a CALL_TO_ACTION button
    - `otp_expiration_seconds` integer — OTP expiration time in seconds for WhatsApp OTP templates
    - `links` object
      - `self` string — URL of the requested resource
      - `account` string — URL of the account

## Other responses

- `400` — **Bad Request:** Code Message Description 1241 'data.wa\_sender\_code' required for WhatsApp template 1254 'data.text' is required Required for SMS, WhatsApp and Viber(text) templates 1256 'data.channel' is required 1257 'data.channel' value should be: \[SMS, VIBER, WHATSAPP\] 1259 'data.name' is invalid 1260 'data.text' is too long Text must be at most 1000 characters 1261 'data.name' is required For WhatsApp name is required 1263 'data.name' is too long Name must be at most 45 characters 1264 'data.url' is required Required for image, video and document templates without 'media\_id' 1265 'data.url' is too long URL must be at most 2083 characters 1266 'data.url' contains invalid characters URL must be valid 1267 'data.filename' is required Required for document templates 1268 'data.filename' is too long Filename must be at most 25 characters 1269 'data.filename' contains invalid characters Filename must only contain \[a-zA-Z0-9\_\] characters 1272 'data.button\_text' is required 1273 'date.button\_value' is invalid it should be a valid phone number in case of PHONE\_CALL type, or valid URL in case of LINK type 1274 'data.button\_text' too long Button Text must be at most 20 characters 1275 The image can be Max 5 MB, format JPG For WhatsApp image template 1276 The video can be Max 16 MB, format MP4 For WhatsApp video template 1277 The document can be Max 100 MB, format PDF For WhatsApp document template 1278 File extension can be only: .bmp, .gif, .jpg, .jpeg, .png, .svg, .webp. maximum size 24 MB For Viber image template 1279 File extension can be only: .3gpp, .m4v, .mov, .mp4. maximum size is 200 MB For Viber video template 1280 File extension can be only: .txt, .doc, .docx, .dot, .dotx, .rtf, .odt, .odf, .fodt, .info.pdf, .xps, .pdax, .eps.xls, .xlsx, .xltx, .xlsm, .csv, .ods, .fods. maximum size 200 MB For Viber document template 1282 URL should start with with 'https://' and have maximum length of 1000 characters For Viber URLs 1283 Document name should be Maximum 25 characters Viber filename must be at most 25 characters 1284 Both 'data.button\_value' and 'data.button\_text' are required in case one of them specified or both of them must be removed For Viber template with buttons 1285 Text + Image combination not allowed (button is missing) For Viber image template 1287 Image and Text combination not supported by Viber For Viber image template 1289 'data.media\_id' is invalid Should be valid UUID 1291 'data.type' is invalid for the selected channel For Viber and Whatsapp should pass valid type 1306 'data.survey\_options' is required and must not be empty for Viber survey templates 1307 'data.carousel\_items' is required and must not be empty for Viber carousel templates For Viber carousel template 1308 'data.carousel\_items' is required and must not be empty for Viber carousel templates Carousel must contain between 2 and 5 items 1310 'data.carousel\_items\[\].action\_url' must start with https:// and have a maximum length of 1000 characters For Viber carousel template 1311 'data.survey\_options' must contain between 2 and 5 options 1313 label max length for primary button is 10 characters Carousel item's primary button's label max length for primary button is 10 characters 1314 Each option in 'data.survey\_options' must not exceed 50 characters For Viber survey template 1315 title should be between 2 and 38 characters Carousel item's title should be between 2 and 38 characters 1316 label max length for secondary button is 12 characters Carousel item's secondary button's label max length for primary button is 10 characters 1317 Primary button is required for carousel template. For Viber carousel template 1319 data.carousel\_items\[\].mediaId' must be a UUID. For Viber carousel template 1320 action url is required for Viber carousel buttons For Viber carousel template 1321 label is required for Viber carousel buttons. For Viber carousel template 1322 text should not exceed 85 characters for Viber survey templates For Viber survey template 1324 'data.carousel\_items\[\].imageUrl' must start with https:// and have a maximum length of 1000 characters For Viber carousel template 1325 Each option in 'data.survey\_options' must not be less than 2 characters. For Viber survey template 1327 'data.viber\_template' is required for Viber OTP and Transactional templates 1328 A parameter named 'code' is required for Viber OTP templates 1329 'data.viber\_template.sender\_code' is required 1332 'data.viber\_template.params' is required 1333 'data.viber\_template.params' must contain at most 5 parameters 1334 'data.viber\_template.params\[\].name' is required 1335 'data.viber\_template.params\[\].name' must not exceed 50 characters 1336 'data.viber\_template.params\[\].name' must contain only English letters, digits, and underscores 1337 'data.viber\_template.params\[\].type' must be TEXT 1338 'data.viber\_template.locales' is required 1339 'data.viber\_template.locales' must contain exactly one locale 1340 'data.viber\_template.locales\[\].lang' is required 1341 'data.viber\_template.locales\[\].template' is required 1342 'data.viber\_template.locales\[\].template' must be between 1 and 875 characters 1343 'data.viber\_template.locales\[\].template' must start with static text, not a placeholder 1344 'data.viber\_template.locales\[\].template' must end with static text, not a placeholder 1345 'data.viber\_template.locales\[\].template' must not contain consecutive placeholders 1346 'data.viber\_template.var\_example' is required 1347 'data.viber\_template.var\_example' must contain at most 5 entries 1348 'data.viber\_template.var\_example\[\].name' is required 1349 'data.viber\_template.var\_example\[\].name' must not exceed 50 characters 1350 'data.viber\_template.var\_example\[\].name' must match a defined parameter name 1351 'data.viber\_template.var\_example\[\].example' must not exceed 100 characters 1352 'data.viber\_template.locales\[\].lang' must be one of the supported language codes 1353 'data.viber\_template.locales\[\].template' must contain a placeholder for every defined param 1354 'data.viber\_category' is required 1355 Failed to register template with Viber. The Viber service is unavailable or returned an error. 1356 'data.type' is invalid for Viber PROMOTIONAL category 1357 'data.viber\_template' must not be provided when 'data.viber\_category' is PROMOTIONAL 1358 'data.type' must be TEXT for Viber OTP and Transactional templates 1359 'data.viber\_template.var\_example\[\].example' must not contain a URL, link, or email address 1360 Only PROMOTIONAL Viber templates can be updated 1361 'data.viber\_category' has an invalid value 1362 'data.viber\_template.locales\[\].template' must not contain a placeholder separated from another placeholder by only 1 or 2 character word 1242 'data.otp\_expiration\_seconds' must be between 30 and 900 seconds. For WhatsApp OTP templates 1243 An issue occurred on WhatsApp's side. Please try again later. WhatsApp provider error during template save 1244 'data.button\_value' may only contain {path} as a dynamic placeholder For WhatsApp CALL\_TO\_ACTION button with dynamic URL 1245 'data.button\_value' must be at most 1950 characters for a CTA Dynamic URL button For WhatsApp CALL\_TO\_ACTION button 1246 'data.button\_url\_example' is required when the CTA URL contains a dynamic placeholder For WhatsApp CALL\_TO\_ACTION button with dynamic URL
- `409` — **Conflict:** Code Message 1258 'data.name' should be unique

---

[API](https://skmtc.net/dexatel/apis/verify-apis.md) · [All operations](https://skmtc.net/dexatel/apis/verify-apis/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/dexatel/verify-apis/revisions/a924257f431d/schema)
