message_template_quality_update webhook reference

Updated: Jun 17, 2026

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_quality_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_quality_update"  
        }  
      ]  
    }  
  ],  
  "object": "whatsapp_business_account"  
}