message_template_components_update webhook reference | Developer Documentation

message_template_components_update webhook reference

Updated: Nov 14, 2025

This reference describes trigger events and payload contents for the WhatsApp Business Account message_template_components_update webhook.

The message_template_components_update webhook notifies you of changes to a ~~template’~~template's components.

Triggers

A template is edited.

Syntax

{

"entry": [
    {
      "id": "<WHATSAPP_BUSINESS_ACCOUNT_ID>",
      "time": <WEBHOOK_TRIGGER_TIMESTAMP>,
      "changes": [
        {
          "value": {
            "message_template_id": <TEMPLATE_ID>,
            "message_template_name": "<TEMPLATE_NAME>",
            "message_template_language": "<TEMPLATE_LANGUAGE_AND_LOCALE_CODE>",
            "message_template_element": "<TEMPLATE_BODY_TEXT>,

<!-- only included if template has a text header -->
            "message_template_title": "<TEMPLATE_HEADER_TEXT>",

<!-- only included if template has a footer -->
            "message_template_footer": "<TEMPLATE_FOOTER_TEXT>",

<!-- only included if template has a url or phone number button -->
            "message_template_buttons": [
              {
                "message_template_button_type": "<BUTTON_TYPE>",
                "message_template_button_text": "<BUTTON_LABEL_TEXT>",

<!--only included for url buttons -->
                "message_template_button_url": "<BUTTON_URL>",

<!--only included for phone number buttons -->
                "message_template_button_phone_number": "<BUTTON_PHONE_NUMBER>"
              }
            ]
          },
          "field": "message_template_components_update"
        }
      ]
    }
  ],
  "object": "whatsapp_business_account"
}

Parameters

Placeholder Description Example value

<BUTTON_LABEL_TEXT>

String

Button label text.

Email support

<BUTTON_PHONE_NUMBER>

String

Button phone number.

+15550783881

<BUTTON_TYPE>

String

Button type.

Values can include:

CATALOGCOPY_CODEEXTENSIONFLOW, MPMORDER_DETAILSOTPPHONE_NUMBERPOSTBACKREMINDERSEND_LOCATIONSPMQUICK_REPLYURLVOICE_CALL

URL

<BUTTON_URL>

String

Button URL.

https://www.luckyshrub.com/support

<TEMPLATE_BODY_TEXT>

String

Template body text.

Thank you for your order, {{1}}! Your order number is {{2}}. If you have any questions, contact support using the buttons below. Thanks again!

<TEMPLATE_FOOTER_TEXT>

String

Template footer text.

Lucky Shrub: the Succulent Specialists!

<TEMPLATE_HEADER_TEXT>

String

Template header text.

Your order is confirmed!

<TEMPLATE_ID>

Integer

Template ID.

1315502779341834

<TEMPLATE_LANGUAGE_AND_LOCALE_CODE>

String

Template language and locale code.

en_US

<TEMPLATE_NAME>

String

Template name.

order_confirmation

<WEBHOOK_TRIGGER_TIMESTAMP>

Integer

Unix timestamp indicating when the webhook was triggered.

1739321024

<WHATSAPP_BUSINESS_ACCOUNT_ID>

String

WhatsApp Business Account ID.

102290129340398

Example

{
"entry": [
    {
"id": "102290129340398",
"time": 1751250234,
"changes": [
        {
"value": {
"message_template_id": 1315502779341834,
"message_template_name": "order_confirmation",
"message_template_language": "en_US",
"message_template_title": "Your order is confirmed!",
"message_template_element": "Thank you for your order, {{1}}! Your order number is {{2}}. If you have any questions, contact support using the buttons below. Thanks again!",
"message_template_footer": "Lucky Shrub: the Succulent Specialists!",
"message_template_buttons": [
              {
"message_template_button_type": "PHONE_NUMBER",
"message_template_button_text": "Phone support",
"message_template_button_phone_number": "+15550783881"
              },
              {
"message_template_button_type": "URL",
"message_template_button_text": "Email support",
"message_template_button_url": "https://www.luckyshrub.com/support"
              }
            ]
          },
"field": "message_template_components_update"
        }
      ]
    }
  ],
"object": "whatsapp_business_account"
}