Skip to main content

message_template_quality_update webhook reference | Developer Documentation

message_template_quality_update webhook reference

Updated: Oct 22, 2025
This reference describes trigger events and payload contents for the WhatsApp Business Account message_template_quality_update webhook.
The message_template_quality_update webhook notifies you of changes to a template’s quality score.

Triggers

    A template’s quality score changes.

    Syntax

    {
  "entry": [
    {
      "id": "<WHATSAPP_BUSINESS_ACCOUNT_ID>",
      "time": <WEBHOOK_TRIGGER_TIMESTAMP>,
      "changes": [
        {
          "value": {
            "previous_quality_score": "<PREVIOUS_QUALITY_SCORE>",
            "new_quality_score": "<NEW_QUALITY_SCORE>",
            "message_template_id": <TEMPLATE_ID>,
            "message_template_name": "<TEMPLATE_NAME>",
            "message_template_language": "<TEMPLATE_LANGUAGE_AND_LOCALE_CODE>"
          },
          "field": "message_template_status_update"
        }
      ]
    }
  ],
  "object": "whatsapp_business_account"
}
    Parameters
    
Placeholder

Description

Example value

    <NEW_QUALITY_SCORE>
    String
    New template quality score.
    Values can be:
    GREEN — Indicates high quality.
    RED — Indicates low quality.
    YELLOW — Indicates medium quality.
    UNKNOWN —  Indicates quality pending.
    GREEN
    <PREVIOUS_QUALITY_SCORE>
    String
    Previous template quality score.
    Values can be:
    GREEN — Indicates high quality.
    RED — Indicates low quality.
    YELLOW — Indicates medium quality.
    UNKNOWN —  Indicates quality pending.
    YELLOW
    <TEMPLATE_ID>
    Integer
    Template ID.
    806312974732579
    <TEMPLATE_NAME>
    String
    Template name.
    welcome_template
    <TEMPLATE_LANGUAGE_AND_LOCALE_CODE>
    String
    Template language and locale code.
    en-US
    <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": 1674864290,
      "changes": [
        {
          "value": {
            "previous_quality_score": "GREEN",
            "new_quality_score": "YELLOW",
            "message_template_id": 806312974732579,
            "message_template_name": "welcome_template",
            "message_template_language": "en-US"
          },
          "field": "message_template_status_update"
        }
      ]
    }
  ],
  "object": "whatsapp_business_account"
}
    
    
            
    
        
    
    
    
        
    
            
    
                
                
    
                    
                    
                
    
            
    
            
            
    
                                            
    
        
    
    
    

    

    
    
    

    
            
    
            
    

    
    
        
    
            
            
        
    
            
    

    
    
        
    
                    
    

        
    No comments to display
    

            
    

    

    

                
    
        
    
                
    
        
    
    
    

    
    

    
    
    
        
    
             Back to top