Whatsapp Business Phone Number

whatsapp.phone_number.name_updated

Notification of business phone number display name validation results.

Trigger condition:

• The display name of the newly created business phone number is reviewed.

• The display names of approved business phone numbers were edited and reviewed.

Example

{
    "eventId": "evt.2011318797020954624",
    "wabaId": "1233466748220443",
    "apiVersion": "v1.0",
    "type": "whatsapp.phone_number.name_updated",
    "value": {
        "display_phone_number": "15550783881",
        "decision": "APPROVED",
        "requested_verified_name": "Lucky Shrub",
        "rejection_reason":"String"
    }
}

Webhook payload structures

Key	Type	Description
display_phone_number	String	The phone number displayed.
decision	String	Represents the result of the business phone number display name validation process.
requested_verified_name	String	A display name collected when creating a business phone number or submitted when editing an approved display name.
rejection_reason	String	The business phone number shows why the name was rejected.

whatsapp.phone_number.quality_updated

Send notifications about changes in the throughput level of a service phone number.

Example

{
    "eventId": "evt.2011321617606508544",
    "wabaId": "1233466748220443",
    "apiVersion": "v1.0",
    "type": "whatsapp.phone_number.quality_updated",
    "value": {
        "display_phone_number": "15550783881",
        "event": "THROUGHPUT_UPGRADE",
        "current_limit": "TIER_UNLIMITED",
        <!-- only included for messaging limit changes -->
        "old_limit":"TIER_10K",
        "max_daily_conversations_per_business":"TIER_UNLIMITED"
    }
}

Webhook payload structures

Key	Type	Description
display_phone_number	String	The phone number displayed.
event	String	Message quota change or throughput change event. ONBOARDING - Indicates that the service phone number is still registered. THROUGHPUT_UPGRADE - Indicates that the throughput level of the service phone number has been increased to a higher throughput.
current_limit	String	This field will be removed in February 2026. Use max_daily_conversations_per_businessinstead. Represents the current message quota or throughput level.
old_limit	String	This parameter will be removed in February 2026. Use max_daily_conversations_per_business instead. Represents the original message quota.
max_daily_conversations_per_business	String	Indicates a change in message quota or throughput for the portfolio of business assets to which it belongs. TIER_50 TIER_250 TIER_2K TIER_10K TIER_10K TIER_NOT_SET TIER_UNLIMITED