# phone_number_quality_update webhook reference | Developer Documentation

<div id="bkmrk-phone_number_quality">## phone\_number\_quality\_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 **phone\_number\_quality\_update** webhook.</div><div>The **phone\_number\_quality\_update** webhook notifies you of changes to a business phone number's [throughput level](/books/meta-whatsapp/page/throughput-developer-documentation).</div><div id="bkmrk-triggers"><div id="bkmrk-triggers-1"><div>### Triggers

</div></div></div>
<span>A business phone number's throughput level changes.</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>`<CURRENT_LIMIT>`</div><div>*String*</div></div></td><td><div><div>**This field will be removed in February, 2026. Use `max_daily_conversations_per_business` instead.**</div><div>Indicates current [messaging limit](/books/meta-whatsapp/page/messaging-limits-developer-documentation) or [throughput](/books/meta-whatsapp/page/throughput-developer-documentation) level.</div><div>Values can be:</div><div>`TIER_50` - Indicates a messaging limit of 50.</div><div>`TIER_250` - Indicates a messaging limit of 250.</div><div>`TIER_2K` - Indicates a messaging limit of 2,000.</div><div>`TIER_10K` - Indicates a messaging limit of 10,000.</div><div>`TIER_100K` - Indicates a messaging limit of 100,000.</div><div>`TIER_NOT_SET` - Indicates the business phone number has not been used to send a message yet.</div><div>`TIER_UNLIMITED` - Indicates the business phone number has higher throughput.</div></div></td><td><div><div>`TIER_UNLIMITED`</div></div></td></tr><tr><td><div><div>`<EVENT>`</div><div>*String*</div></div></td><td><div><div>[Messaging limit](/books/meta-whatsapp/page/messaging-limits-developer-documentation) change or [throughput](/books/meta-whatsapp/page/throughput-developer-documentation) change event.</div><div>Values can be:</div><div>`ONBOARDING` - Indicates the business phone number is still being registered.</div><div>`THROUGHPUT_UPGRADE` - Indicates the business phone number's throughput level has increased to higher throughput.</div></div></td><td><div><div>`THROUGHPUT_UPGRADE`</div></div></td></tr><tr><td><div><div>`<MAX_DAILY_MESSAGES_LIMIT>`</div><div>*String*</div></div></td><td><div><div>Indicates a change to the owning business portfolio's [messaging limit](/books/meta-whatsapp/page/messaging-limits-developer-documentation) or [throughput](/books/meta-whatsapp/page/throughput-developer-documentation) change.</div><div>Values can be:</div><div>`TIER_50` - Indicates a messaging limit of 50.</div><div>`TIER_250` - Indicates a messaging limit of 250.</div><div>`TIER_2K` - Indicates a messaging limit of 2,000.</div><div>`TIER_10K` - Indicates a messaging limit of 10,000.</div><div>`TIER_100K` - Indicates a messaging limit of 100,000.</div><div>`TIER_NOT_SET` - Indicates the business phone number has not been used to send a message yet.</div><div>`TIER_UNLIMITED` - Indicates the business phone number has higher throughput.</div></div></td><td><div><div>`TIER_2K`</div></div></td></tr><tr><td><div><div>`<OLD_LIMIT>`</div><div>*String*</div></div></td><td><div><div>**This parameter will be removed in February, 2026. Use `max_daily_conversations_per_business` instead.**</div><div>Indicates old [messaging limit](/books/meta-whatsapp/page/messaging-limits-developer-documentation).</div><div>Values can be:</div><div>`TIER_50` - Indicates a messaging limit of 50.</div><div>`TIER_250` - Indicates a messaging limit of 250.</div><div>`TIER_2K` - Indicates a messaging limit of 2,000.</div><div>`TIER_10K` - Indicates a messaging limit of 10,000.</div><div>`TIER_100K` - Indicates a messaging limit of 100,000.</div><div>`TIER_NOT_SET` - Indicates the business phone number has not been used to send a message yet.</div></div></td><td><div><div>`TIER_UNLIMITED`</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>