--- title: "Create WhatsApp text message template (Endpoint)" method: POST path: "/v2/whatsapp/templates/" tags: ["Templates"] --- # Create WhatsApp text message template (Endpoint) `POST /v2/whatsapp/templates/` ## Request - Base URL: `https://elastic.messangi.me/balerion` - URL: `https://elastic.messangi.me/balerion/v2/whatsapp/templates/` - Auth: HTTP bearer Requires authentication — see [Authentication](/reference/authentication-overview). Create a simple WhatsApp text message template. This type of message template allows you to predefine the configuration of text message and personalized fields (placeholders). If you want to create the text message template via Message Templates API, you need to provide (**required**) the [WhatsApp Business Account ID (`wabaId`)](/docs/whatsapp-business-step-by-step-onboarding#step-2-whatsapp-business-account-id-waba). To know how to create a text message template go to the [Creating & Sending WhatsApp Text Message Template](/docs/creating-sending-whatsapp-text-messages-templates#creating-a-text-message-template) section. ## Query parameters - `wabaId` string ## Request body - TemplateDTO - `name` string, required: Name of the message template created in your WhatsApp Business Account. The name of each message template you create cannot be the same. - `category` 'MARKETING' | 'UTILITY', required: Type of message template. Supported Message Template Categories for WhatsApp Text Message Template. - `MARKETING`: Send promotional offers, product announcements, and more to increase awareness and engagement. - `UTILITY`: Send account updates, order updates, alerts, and more to share important information. - `templateLanguages` TemplateLanguageRequest[], required: Array of languages objects containing the language that message template may be rendered in and the components. - `language` string, required: Language of the message template. Currently the API supports 3 Languages: English, Spanish and Portuguese. Required if you want to send message templates in languages other than English. **English**: `en`, `en_GB`, `en_US` **Spanish**: `es`, `es_AR`, `es_ES` **Portuguese**: `pt_BR`, `pt_PT` - `components` TemplateComponentManager[], required: The parts of the message template. Array of **components** objects containing the different types of options you can include in the message. - `type` 'BODY', required: Type of component of the message template you want to send. - `BODY` (Required): The main content of the message template. - `text` string: Content of the text message template that will be sent to the end user. Emojis and markdown are supported. Maximum length: 1024 characters. For instance, let's compose the following message that includes a line break ( ) and this emoji (😀): ´`We are pleased to present our new product: The Amplifier 480xAr :grinning:` - `example` ExampleComponentManager: It is required when the body contains **placeholders**. - `body_text` array[]: It is required when the body contains **placeholders.** Specifies the value(s) as a sample data for the placeholder(s) defined in the `templateLanguages.components.text` parameter for Body type. Array of personalized fields values containing the text message body. - string[] ## Response `201` 201 - TemplateResponse - `meta` MetadataDTO - `timestamp` integer, required: Transaction's date in timestamp. - `transactionId` string, required: Id for the current transaction (Endpoint's call). - `explain` string: Explain string in case of failure. - `errors` ErrorsDTO: An error in the process. - `reason` string: Failure reason. - `details` object: List of errors if any. i.e. { key: value ... }. - `reason` string - `data` Template - `wabaId` integer: WhatsApp Business Account ID. - `name` string, required: Name of the message template created in your WhatsApp Business Account. The name of each message template you create cannot be the same. - `category` string, required: Type of message template. Supported Message Template Categories for WhatsApp Text Message Template. - `MARKETING`: Send promotional offers, product announcements, and more to increase awareness and engagement. - `UTILITY`: Send account updates, order updates, alerts, and more to share important information. - `templateLanguages` TemplateLanguageResponse[], required: Array of languages objects containing the language that message template may be rendered in and the components. - `id` string: Unique identifier of the message template. - `language` string, required: Language of the message template. Currently the API supports 3 Languages: English, Spanish and Portuguese. Required if you want to send message templates in languages other than English. **English**: `en`, `en_GB`, `en_US` **Spanish**: `es`, `es_AR`, `es_ES` **Portuguese**: `pt_BR`, `pt_PT` - `components` TemplateComponentManager[], required: The parts of the message template. Array of **components** objects containing the different types of options you can include in the message. - `type` 'BODY', required: Type of component of the message template you want to send. - `BODY` (Required): The main content of the message template. - `text` string: Content of the text message template that will be sent to the end user. Emojis and markdown are supported. Maximum length: 1024 characters. For instance, let's compose the following message that includes a line break ( ) and this emoji (😀): ´`We are pleased to present our new product: The Amplifier 480xAr :grinning:` - `example` ExampleComponentManager: It is required when the body contains **placeholders**. - `body_text` array[]: It is required when the body contains **placeholders.** Specifies the value(s) as a sample data for the placeholder(s) defined in the `templateLanguages.components.text` parameter for Body type. Array of personalized fields values containing the text message body. - string[] - `disabledTrackingButton` boolean: *Optional*. Only applies when the **Media Message Template** contains **buttons**. Indicates whether Meta's button click tracking should be enabled or disabled for WhatsApp message templates that include interactive buttons. - `true`: Enables Meta’s behavior to track and report button click events. - `false` (default): Disables tracking of button clicks. No analytics will be collected for button interactions by Meta. ## Other responses - `206`: 206 - `400`: Bad request - `401`: Unauthorized - `404`: info not found - `500`: Internal server error --- [API](https://skmtc.dev/messangi/apis/whatsapp-create-text-template.md) - [All operations](https://skmtc.dev/messangi/apis/whatsapp-create-text-template/llms.txt) - [OpenAPI document](https://skmtc.dev/messangi/apis/whatsapp-create-text-template/revisions/ccf348a2d490?raw)