# phone_number_name_update webhook reference | Developer Documentation

<div id="bkmrk-phone_number_name_up">## phone\_number\_name\_update webhook reference

<div><span>Updated: Oct 22, 2025</span></div><div>This reference describes trigger events and payload contents for the WhatsApp Business Account **phone\_number\_name\_update** webhook.</div><div>The **phone\_number\_name\_update** webhook notifies you of business phone number [display name verification](/books/meta-whatsapp/page/display-names-developer-documentation) outcomes.</div><div id="bkmrk-triggers"><div id="bkmrk-triggers-1"><div>### Triggers

</div></div></div>
<span>A newly created business phone number's display name is reviewed.</span><span>A business phone number's already approved display name is edited and reviewed.</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>`<BUSINESS_DISPLAY_PHONE_NUMBER>`</div><div>*String*</div></div></td><td><div><div>Business display phone number.</div></div></td><td><div><div>`15550783881`</div></div></td></tr><tr><td><div><div>`<DECISION>`</div><div>*String*</div></div></td><td><div><div>Indicates the outcome of the business phone number [display name verification](/books/meta-whatsapp/page/business-phone-numbers-developer-documentation) process.</div><div>`APPROVED` - Indicates the display name has been approved and will now appear at the top of the business phone number's profile in the WhatsApp client.</div><div>`DEFERRED` - Indicates a decision has been deferred.</div><div>`PENDING` - Indicates a decision is still pending further review.</div><div>`REJECTED` - Indicates the display name has been rejected. You can edit the name using [WhatsApp Manager<span>?</span>](https://business.facebook.com/latest/whatsapp_manager/overview/). Review our [display name guidelines<span>?</span>](https://www.facebook.com/business/help/757569725593362) before editing.</div></div></td><td><div><div>`APPROVED`</div></div></td></tr><tr><td><div><div>`<REJECTION_REASON>`</div><div>*String*</div></div></td><td><div><div>The reason why the business phone number display name was rejected, if it was rejected. Review our display name guidelines for common rejection reasons.</div><div>Values can be:</div><div>`NAME_EMPLOYEE_ISSUE` - Rejected because the display name included a person's name or employee identifier.</div><div>`NAME_ENDCLIENT_NOTRELATED` - Rejected because the display name included an unrelated business's name.</div><div>`NAME_FORMAT_UNACCEPTABLE` - Rejected because the display name used an unacceptable format.</div><div>`NAME_INDIVIDUAL_ISSUE` - Rejected because the display name included a person's name or employee identifier. `NAME_NOT_CONSISTENT` - Rejected because the display name was not consistent with the business's branding.</div><div>`null` - Indicates name was accepted.</div><div>`UNKNOWN` - Rejected for an unknown reason. Please contact support.</div></div></td><td><div><div>`APPROVED`</div></div></td></tr><tr><td><div><div>`<REQUESTED_DISPLAY_NAME>`</div><div>*String*</div></div></td><td><div><div>The business phone number display name collected when the number was created, or name submitted when editing an already approved display name.</div></div></td><td><div><div>`Lucky Shrub`</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></tbody></table>

</div></div>