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.

    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