# message_template_status_update webhook reference | Developer Documentation

<div id="bkmrk-message_template_sta">## message\_template\_status\_update webhook reference

<div><span>Updated: Nov 14, 2025</span></div><div>This reference describes trigger events and payload contents for the WhatsApp Business Account `message_template_status_update` webhook.</div><div>The **message\_template\_status\_update** webhook notifies you of changes to the status of an existing template.</div><div id="bkmrk-triggers"><div id="bkmrk-triggers-1"><div>### Triggers

</div></div></div>
<span>A template is approved.</span><span>A template is rejected.</span><span>A template is disabled.</span><div id="bkmrk-parameters"><div id="bkmrk-parameters-1"><div>### Parameters

</div></div></div><div><table><thead><tr><th><span>Placeholder </span></th><th><span>Description </span></th><th><span>Example value </span></th></tr></thead><tbody><tr><td><div><div>`<DESCRIPTION>`</div><div>*String*</div></div></td><td><div><div>String describing why the template was locked or unlocked.</div></div></td><td><div><div>Your WhatsApp message template has been unpaused.</div></div></td></tr><tr><td><div><div>`<DISABLE_TIMESTAMP>`</div><div>*Integer*</div></div></td><td><div><div>Unix timestamp indicating when the template was disabled.</div></div></td><td><div><div>`1751234563`</div></div></td></tr><tr><td><div><div>`<EVENT>`</div><div>*String*</div></div></td><td><div><div>Template status event. Values can be:</div><div>`APPROVED` - Indicates the template has been approved and can now be sent in template messages.</div><div>`ARCHIVED`: Indicates the template has been archived to keep the list of templates in WhatsApp manager clean. `DELETED` - Indicates the template has been deleted.</div><div>`DISABLED` - Indicates the template has been disabled due to user [feedback](/books/meta-whatsapp/page/template-quality-rating-developer-documentation).</div><div>`FLAGGED` - Indicates the template has received negative feedback and is at risk of being disabled.</div><div>`IN_APPEAL` - Indicates the template is in the [appeal](/books/meta-whatsapp/page/template-review-developer-documentation) process.</div><div>`LIMIT_EXCEEDED` - Indicates the WhatsApp Business Account template is at its [template limit](/books/meta-whatsapp/page/templates-developer-documentation).</div><div>`LOCKED` - Indicates the template has been locked and cannot be edited.</div><div>`PAUSED` - Indicates the template has been [paused](/books/meta-whatsapp/page/template-pausing-developer-documentation).</div><div>`PENDING` - Indicates the template is undergoing template review.</div><div>`REINSTATED` - Indicates the template is no longer flagged or disabled and can be sent in template messages again.</div><div>`PENDING_DELETION` - Indicates template has been deleted via WhatsApp Manager.</div><div>`REJECTED` - Indicates the template has been rejected. You can [edit the template](/books/meta-whatsapp/page/templates-developer-documentation) to have it undergo template review again or [appeal](/books/meta-whatsapp/page/template-review-developer-documentation) the rejection.</div></div></td><td><div><div>`APPROVED`</div></div></td></tr><tr><td><div><div>`<TEMPLATE_ID>`</div><div>*Integer*</div></div></td><td><div><div>Template ID.</div></div></td><td><div><div>`1689556908129832`</div></div></td></tr><tr><td><div><div>`<TEMPLATE_NAME>`</div><div>*String*</div></div></td><td><div><div>Template name.</div></div></td><td><div><div>`order_confirmation`</div></div></td></tr><tr><td><div><div>`<TEMPLATE_LANGUAGE_AND_LOCALE_CODE>`</div><div>*String*</div></div></td><td><div><div>Template [language and locale](/books/meta-whatsapp/page/template-library-developer-documentation) code.</div></div></td><td><div><div>`en-US`</div></div></td></tr><tr><td><div><div>`<REASON>`</div><div>*String*</div></div></td><td><div><div>Template rejection reason, if rejected.</div><div>If the template is scheduled for deletion, the value will be `null` instead of a string. Otherwise, values can be:</div><div>`ABUSIVE_CONTENT` - Indicates template contains content that violates our policies.</div><div>`CATEGORY_NOT_AVAILABLE` - (Deprecated) Indicates an authentication templates for an unsupported region.</div><div>`INCORRECT_CATEGORY` - Indicates the template's content doesn't match the category designated at the time of template creation.</div><div>`INVALID_FORMAT` - Indicates template has an invalid format.</div><div>`NONE`: Indicates template was paused.</div><div>`PROMOTIONAL` - Indicates template contains content that violates our policies.</div><div>`SCAM` - Indicates template contains content that violates our policies.</div><div>`TAG_CONTENT_MISMATCH` - Indicates the template's content doesn't match the category designated at the time of template creation.</div></div></td><td><div><div>`INVALID_FORMAT`</div></div></td></tr><tr><td><div><div>`<TITLE>`</div><div>*String*</div></div></td><td><div><div>Title of template pause or unpause event.</div><div>Values can be:</div><div>`FIRST_PAUSE` - Indicates template has been paused for the first time.</div><div>`SECOND_PAUSE` - Indicates the template has been paused a second time.</div><div>`RATE_LIMITING_PAUSE` - Indicates template has been paused due to rate limiting.</div><div>`UNPAUSE` - Indicates template has been unpaused.</div><div>`DISABLED` - Indicates template has been disabled.</div></div></td><td><div><div>`FIRST_PAUSE`</div></div></td></tr><tr><td><div><div>`<WEBHOOK_TRIGGER_TIMESTAMP>`</div><div>*Integer*</div></div></td><td><div><div>Unix timestamp indicating when the webhook was triggered.</div></div></td><td><div><div>`1739321024`</div></div></td></tr><tr><td><div><div>`<WHATSAPP_BUSINESS_ACCOUNT_ID>`</div><div>*String*</div></div></td><td><div><div>WhatsApp Business Account ID.</div></div></td><td><div><div>`102290129340398`</div></div></td></tr><tr><td><div><div>`<MESSAGE_TEMPLATE_CATEGORY>`</div><div>*String*</div></div></td><td><div><div>The template category.</div><div>Values can be:</div><div>`MARKETING` - Indicates template is categorized as MARKETING.</div><div>`UTILITY` - Indicates the template is categorized as UTILITY.</div><div>`AUTHENTICATION` - Indicates template is categorized as AUTHENTICATION.</div></div></td><td><div><div>`MARKETING`</div></div></td></tr><tr><td><div><div>`<REASON_INFO>`</div><div>*String*</div></div></td><td><div><div>Provides a detailed explanation for why the template was rejected. This field describes the specific issue detected in the template content.</div></div></td><td><div><div>`Your template has parameters placed next to each other (like {{1}}{{2}}) without text or punctuation between them.`</div></div></td></tr><tr><td><div><div>`<RECOMMENDATION_INFO>`</div><div>*String*</div></div></td><td><div><div>Offers actionable guidance on how to modify the template to resolve the rejection reason. This field suggests best practices for editing the template content.</div></div></td><td><div><div>`Separate parameters with descriptive text and ensure each parameter is clearly contextualized.`</div></div></td></tr></tbody></table>

</div></div>