Create and manage Template Messages

You can create and manage Template Messages using either the API or the UI. This guide explains both methods, so you can choose the option that best fits your workflow. You may combine both approaches or simply use the one that is most efficient for your scenario.

• Via API

• Create and manage Template Messages

Via API

Create new WABA template

Please use this endpoint.

The message template name field is limited to 512 characters. The message template content field is limited to 1024 characters.

Headers

Name	Type	Description
D360-API-KEY*	string

Body Properties

Placeholder	Description	Sample Value
<NAME> String	Required. Template name. Maximum 512 characters.	order_confirmation
<CATEGORY> Enum	Required. Template category.	Allowed values: AUTHENTICATION, MARKETING, UTILITY
<LANGUAGE> Enum	Required. Template language and locale code.	en_US
<LIBRARY_TEMPLATE_NAME> String	Optional. The exact name of the Utility Template Library template. Learn how to create templates using Utility Template Library	delivery_update_1
<LIBRARY_TEMPLATE_BUTTON_INPUTS> Array of objects	Optional. The website and/or phone number of the business being used in the template. Note: For utility templates that contain buttons, this property is not optional. Learn how to create templates using Utility Template Library	“[ {'type': 'URL', 'url': {'base_url' : 'https://www.example.com/{{1}}', 'url_suffix_example' : 'https://www.example.com/demo'}}, {type: 'PHONE_NUMBER', 'phone_number': '[phone]'} ]"
<COMPONENTS> Array of objects	Required. Components that make up the template. See Template Elements.	See Template Elements.

Request body

Templates are composed of various text, media, and interactive components, based on your business needs. Refer to the Template Elements for a list of all possible components.

When creating a template, define its components by assigning an array of component objects to the components property in the body of the request.

For example, here's an array containing a text body component with two variables and sample values, a phone number button component, and a URL button component:

[
  {
    "type": "BODY",
    "text": "Thank you for your order, {{1}}! Your confirmation number is {{2}}. If you have any questions, please use the buttons below to contact support. Thank you for being a customer!",
    "example": {
      "body_text": [
        [
          "Pablo","confirmation_number"
        ]
      ]
    }
  },
  {
    "type": "BUTTONS",
    "buttons": [
      {
        "type": "PHONE_NUMBER",
        "text": "Call",
        "phone_number": "phone_number"
      },
      {
        "type": "URL",
        "text": "Contact Support",
        "url": "https://www.website.com/support"
      }
    ]
  }
]

Note that templates categorized as AUTHENTICATION have unique component requirements. See Authentication Templates.

200: OK

In addition, if Meta determines that a template has been miscategorized, its status will be set to REJECTED and you will receive a template status webhook indicating that it was rejected for miscategorization.

{
  "category": "MARKETING",
  "components": [
    {
      "example": {
        "body_text": [
          [
            "Lorem"
          ]
        ]
      },
      "text": "Lorem {{1}} ipsum",
      "type": "BODY"
    }
  ],
  "created_at": "2024-06-25T09:42:33Z",
  "created_by": {
    "user_id": "360dialog_user_id",
    "user_name": "360dialog_user_name"
  },
  "external_id": "template_external_id",
  "id": "template_id",
  "language": "en_US",
  "modified_at": "2024-06-25T09:42:37Z",
  "modified_by": {
    "user_id": "360dialog_user_id",
    "user_name": "360dialog_user_name"
  },
  "name": "string",
  "namespace": "string",
  "partner_id": "string",
  "quality_score": null,
  "rejected_reason": null,
  "status": "submitted",
  "updated_external": true,
  "waba_account_id": "string"
}

400: Bad Request

{
  "meta": {
    "success": false,
    "http_code": 400,
    "developer_message": "There was an error with your request",
    "details": [
      "string"
    ],
    "error_data": {
      "code": "string",
      "message": "string",
      "real_message": "string",
      "status": 0
    }
  }
}

404: Not Found

{
  "meta": {
    "success": false,
    "http_code": 400,
    "developer_message": "There was an error with your request",
    "details": [
      "string"
    ],
    "error_data": {
      "code": "string",
      "message": "string",
      "real_message": "string",
      "status": 0
    }
  }
}

After April 9, 2025 Meta no longer supports allow_category_change property. Previously, if set to true in a template creation request, this allowed Meta to update a template’s category to marketing automatically. This is now the default behaviour.

Get WABA templates

Please use this endpoint.

See Template Statuses

Query Parameters

Name	Type	Description
filters	string	A JSON object of params and their expected values id , partner_id , business_templates.name, status , category
limit	string	Objects limit to return in the response default: 1000
offset	string	Show the results starting from an offset default: 0
sort	string	Use minus - symbol for descending sorting id , name , status

Headers

Name	Type	Description
D360-API-KEY*	string

200: OK

{
  "count": 0,
  "filters": [],
  "limit": 1000,
  "offset": 0,
  "sort": ["id"],
  "total": 0,
  "waba_templates": [
    {
      "category": "string",
      "components": [
        {
          "format": "string",
          "type": "string"
        },
        {
          "text": "string",
          "type": "string"
        }
      ],
      "external id": "string"
      "language": "string",
      "name": "string",
      "namespace": "string",
      "rejected_reason": "string",
      "status": "string"
    }
  ]
}

404: Not Found

{
  "meta": {
    "success": false,
    "http_code": 400,
    "developer_message": "There was an error with your request",
    "details": [
      "string"
    ],
    "error_data": {
      "code": "string",
      "message": "string",
      "real_message": "string",
      "status": 0
    }
  }
}

Remove a Template Message

Before deleting a Template Message, keep the following points in mind:

• Pending delivery: Messages that have already been sent but not yet delivered (e.g., if the customer’s device is offline) will continue to attempt delivery for up to 30 days.

• After deletion: If a message is sent from a previously approved template 30 days after deletion, you will receive a "Structure Unavailable" error, and the customer will not receive the message.

• Name reuse restriction: Once a template is deleted, its name cannot be reused for 30 days. To create a new template during this period, use a different name.

• Template elements: For details on the components available in a Template Message, see Template Elements.

How to remove a Template Message

You can delete a WABA Template Message by using either its name or template ID.

• Remove by template ID

• Remove by template name

Refer to Get WABA templates to get a template name or ID.

Remove by template ID

To delete a template message by ID, you may need to retrieve the ID and in the request by including the template's ID:

• Only the template with the specified Template ID will be deleted.

• Each template has a unique ID for each language, so make sure you use the correct Template ID when making a deletion request.

Please use this endpoint.

Remove by template name

Deleting a template by name deletes all templates that match that name (meaning templates with the same name but different languages will also be deleted).

Please use this endpoint.

Update template

Please use this endpoint.

Via UI - 360Dialog Hub

The Template Management feature in the 360Dialog Hub supports both text and media templates. To manage Template Messages in the UI, you will need to access the Channel details, which have the following functions:

• Create and preview new template messages

• Monitor current approval status of all your templates

• Copy and Delete templates

• Add different template Languages

• Allow template category change

• Edit Templates

Access

Each WABA has it's own set of Message Templates. To access your Message Templates, find the WhatsApp accounts section, select the number you would like to add a Message Template to in the WhatsApp accoutns section > Channel Details > Templates.

In Channel details > Templates

How to create a new waba template

The process is described in detail here.