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

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

Last updated