phone_number_quality_update webhook reference | Developer Documentation

This reference describes trigger events and payload contents for the WhatsApp Business Account phone_number_quality_update webhook.

The phone_number_quality_update webhook notifies you of changes to a business phone number's throughput level.

Placeholder	Description	Example value
<BUSINESS_DISPLAY_PHONE_NUMBER> String	Business display phone number.	15550783881
<CURRENT_LIMIT> String	This field will be removed in February, 2026. Use max_daily_conversations_per_business instead. Indicates current messaging limit or throughput level. Values can be: TIER_50 - Indicates a messaging limit of 50. TIER_250 - Indicates a messaging limit of 250. TIER_2K - Indicates a messaging limit of 2,000. TIER_10K - Indicates a messaging limit of 10,000. TIER_100K - Indicates a messaging limit of 100,000. TIER_NOT_SET - Indicates the business phone number has not been used to send a message yet. TIER_UNLIMITED - Indicates the business phone number has higher throughput.	TIER_UNLIMITED
<EVENT> String	Messaging limit change or throughput change event. Values can be: ONBOARDING - Indicates the business phone number is still being registered. THROUGHPUT_UPGRADE - Indicates the business phone number's throughput level has increased to higher throughput.	THROUGHPUT_UPGRADE
<MAX_DAILY_MESSAGES_LIMIT> String	Indicates a change to the owning business portfolio's messaging limit or throughput change. Values can be: TIER_50 - Indicates a messaging limit of 50. TIER_250 - Indicates a messaging limit of 250. TIER_2K - Indicates a messaging limit of 2,000. TIER_10K - Indicates a messaging limit of 10,000. TIER_100K - Indicates a messaging limit of 100,000. TIER_NOT_SET - Indicates the business phone number has not been used to send a message yet. TIER_UNLIMITED - Indicates the business phone number has higher throughput.	TIER_2K
<OLD_LIMIT> String	This parameter will be removed in February, 2026. Use max_daily_conversations_per_business instead. Indicates old messaging limit. Values can be: TIER_50 - Indicates a messaging limit of 50. TIER_250 - Indicates a messaging limit of 250. TIER_2K - Indicates a messaging limit of 2,000. TIER_10K - Indicates a messaging limit of 10,000. TIER_100K - Indicates a messaging limit of 100,000. TIER_NOT_SET - Indicates the business phone number has not been used to send a message yet.	TIER_UNLIMITED
<WEBHOOK_TRIGGER_TIMESTAMP> Integer	Unix timestamp indicating when the webhook was triggered.	1739321024
<WHATSAPP_BUSINESS_ACCOUNT_ID> String	WhatsApp Business Account ID.	102290129340398