Skip to main content

template_category_update webhook reference | Developer Documentation

template_category_update webhook reference

Updated: Nov 11, 2025
This reference describes trigger events and payload contents for the WhatsApp Business Account template_category_update webhook.
The template_category_update webhook notifies you of changes to template's category.

Triggers

    The existing category of a WhatsApp template is going to be changed by an automated process.The existing category of a WhatsApp template is changed manually or by an automated process.

    Parameters

    Placeholder Description Example value
    <CORRECT_CATEGORY>
    String
    The category that the template will be recategorized as in 24 hours.
    MARKETING
    <CURRENT_CATEGORY>
    String
    The template's current category.
    MARKETING
    <NEW_CATEGORY>
    String
    The template's new category.
    MARKETING
    <CATEGORY_UPDATE_TIMESTAMP>
    Integer
    The Unix timestamp (in seconds) indicating when the template's category will be updated to the <CORRECT_CATEGORY> specified in the webhook. This value represents the moment the update is scheduled to occur.
    1760711433
    <PREVIOUS_CATEGORY>
    String
    The template's previous category.
    UTILITY
    <TEMPLATE_ID>
    Integer
    Template ID.
    278077987957091
    <TEMPLATE_LANGUAGE>
    String
    en-US
    <TEMPLATE_NAME>
    String
    Template name.
    welcome_template
    <WEBHOOK_TRIGGER_TIMESTAMP>
    Integer
    Unix timestamp indicating when the webhook was triggered.
    1739321024
    <WHATSAPP_BUSINESS_ACCOUNT_ID>
    String
    WhatsApp Business Account ID.
    102290129340398

    Examples

    This example webhook describes a template that will be recategorized as MARKETING in 24 hours. Note that new_category indicates its current category:
    

    

    This example webhook describes a template that has been recategorized as MARKETING:
    

    

    
    
            
    
    
    

            
    
        
    
    
    

    
    

    
    
    
        
    
             Back to top