Skip to main content

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’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
    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"
      }
      
    
              
      
        
      
    
      
        
      
            
      
                
                
      
                    
                    
                
      
            
      
            
            
      
                                            
      
        
      
    
      

    

      
    
      

    
            
      
            
      

    
      
        
      
            
            
        
      
            
      

    
      
        
      
                    
      

        
      No comments to display
      

            
      

    

    

                  
      
        
      
                
      
        
      
    
      

    
      

    
    
      
        
      
             Back to top