Whatsapp Business Account

whatsapp.business_account.updated

A partner of a WhatsApp Business account leads a company verification submission, its international verification rate eligibility or principal place of business, when sharing with a solution provider, or violates a policy or terms.

Example

{
    "eventId": "evt.2009764703160500224",
    "wabaId": "877138684687780",
    "apiVersion": "v1.0",
    "type": "whatsapp.business_account.updated",
    "value": {
    <!--only included for  BUSINESS_PRIMARY_LOCATION_COUNTRY_UPDATE event -->
    "country": "<COUNTRY_CODE>",
    "event": "<EVENT>",
    <!-- only included for AD_ACCOUNT_LINKED event -->
    "waba_info": {
            "waba_id": "<WABA_ID>",
            "ad_account_linked": "<AD_ACCOUNT_ID>",
            "owner_business_id": "<BUSINESS_PORTFOLIO_ID>"
   },
   <!-- only included for ACCOUNT_VIOLATION event -->
   "violation_info": {
            "violation_type": "<VIOLATION_TYPE>"
  },
  <!-- only included for AUTH_INTL_PRICE_ELIGIBILITY_UPDATE event -->
  "auth_international_rate_eligibility": {
            "exception_countries": [
                {
                    "country_code": "<EXCEPTION_COUNTRY_CODE>",
                    "start_time": <EXCEPTION_START_TIME>
                }
            ],
            "start_time": <START_TIME>
  },
  <!-- only included for DISABLED_UPDATE event -->
  "ban_info": {
            "waba_ban_state": "<WABA_BAN_STATE>",
            "waba_ban_date": "<WABA_BAN_DATE>"
  },
 <!-- only included for MM_LITE_TERMS_SIGNED event -->
 "waba_info": {
            "waba_id": "<WABA_ID>",
            "owner_business_id": "<BUSINESS_PORTFOLIO_ID>"
  },
 <!-- only included for PARTNER_* events -->
  "waba_info": {
            "waba_id": "<CUSTOMER_WABA_ID>",
            "owner_business_id": "<CUSTOMER_BUSINESS_PORTFOLIO_ID>",

              <!-- only included for PARTNER_APP_INSTALLED, PARTNER_APP_UNINSTALLED events -->
              "partner_app_id": "<PARTNER_APP_ID>",

              <!-- only included if customer onboarded via a multi-partner solution,
                   omitted from PARTNER_APP_UNINSTALLED events -->
              "solution_id": "<SOLUTION_ID>",
            "solution_partner_business_ids": [
                "<PARTNER_IDS>"
            ]
  },
  <!-- only included for PARTNER_CLIENT_CERTIFICATION_STATUS_UPDATE event -->
   "partner_client_certification_info": {
            "client_business_id": "<CUSTOMER_BUSINESS_PORTFOLIO_ID>",
            "status": "<STATUS>",
            "rejection_reasons": [
                "<REJECTION_REASONS>"
            ]
        }
    }
}

Webhook payload structures

Key

Type

Description

<COUNTRY_CODE>

String

We determine the ISO 3166-1 alpha-2 country code for the country/region where the merchant is located.arrow-up-right

<EVENT>

String

WhatsApp Business account (" WABA ") event. ACCOUNT_VIOLATION - Indicates that WABA has violated one of our policies or termsarrow-up-right.

AD_ACCOUNT_LINKED -- Indicates that WABA has accessed Lite Edition marketing messages through embedded sign-up or intent apis and authorized partners to access their advertising accounts. AUTH_INTL_PRICE_ELIGIBILITY_UPDATE - Indicates that WABA is eligible to use international authentication ratesarrow-up-right. BUSINESS_PRIMARY_LOCATION_COUNTRY_UPDATE -- Indicates that the primary place of business for WABA is set.

DISABLED_UPDATE - Indicates that WABA has violated one of our policies or termsarrow-up-right.

MM_LITE_TERMS_SIGNED -- Indicates that WABA has successfully accepted the Lite version of the Marketing Messaging Service Terms.

PARTNER_ADDED - Indicates that WABA has been shared with the solution providerarrow-up-right.

PARTNER_APP_INSTALLED - Indicates that the business customer has granted an additional permission to the application.

PARTNER_APP_UNINSTALLED - Indicates that the business customer has unauthenticated or uninstalled the application. PARTNER_CLIENT_CERTIFICATION_STATUS_UPDATE -- Indicates that WABA's partner lead company verifiesarrow-up-right that a submission has been approved, rejected, or deprecated.

PARTNER_REMOVED - Indicates that the WABA shared with the solution providerarrow-up-right has been removed from sharing.

<EXCEPTION_COUNTRY_CODE>

String

The ISO 3166-1 alpha-2 country code for the country where the start time is exceptional.

<EXCEPTION_START_TIME>

int

Unix timestamp indicating the start time of the international authentication rate for the exception country.

<PARTNER_IDS>

Array

A string consisting of the technology broker (or technology partner) associated with the multi-partner solution and the business asset portfolio number of the solution partner.

<REJECTION_REASONS>

Array

Partner-led companies verify why submissions are rejected.

<SOLUTION_ID>

String

Multi-partner solution Solution number.

<START_TIME>

int

Unix timestamp indicating the start time of all countries/territories eligible for international authentication rates.

<STATUS>

String

The partner-led company verifies the submission status.

<VIOLATION_TYPE>

String

Type of violationarrow-up-right. See the violation for a list of possible values.

<WABA_BAN_STATE>

String

WABA blocked status.

<WABA_BAN_DATE>

String

Indicates the time that the WABA was banned.

whatsapp.business_account.alerted

Notifies you when your business phone number's message limit, business home page, and official business account status change.

Example

Webhook payload structures

Key

Type

Description

entity_type

String

Alert type.

BUSINESS - Indicates changes related to the business portfolio of assets. PHONE_NUMBER - Indicates a change related to the business phone number. CURRENT_STATUS_ID - Indicates changes related to the business home page of the business phone number

entity_id

String

The value can be a business portfolio id or a business phone number number.

alert_status

String

Alert status.

  • ACTIVE

  • NONE

alert_description

String

Alert description.

alert_severity

String

Alert severity.

CRITICAL - means to reject or reject. The alert_description value may describe actions that can be taken to address the root cause of the dismissal or rejection.

INFORMATIONAL - Indicates that the Webhook contains only informational data and no action is required.

WARNING - Indicates that action may be required. The alert_description value describes the possible actions that can be taken

alert_type

String

Alert type.

whatsapp.business_account.deleted

The business account was deleted.

Example

whatsapp.business_account.reviewed

To notify you when your WhatsApp Business account is audited in accordance with our policy guidelines.

Trigger condition:

  • WhatsApp Business account approved.

  • WhatsApp Business account was not approved.

  • The decision to review WhatsApp Business accounts has been delayed or is pending further information.

Example

Webhook payload structures

Key

Type

Description

decision

String

WhatsApp Business account review results.

  • APPROVED - Indicates that WABA has been approved and can be put into use.

  • REJECTED - Indicates that WABA has been denied access to our API for not meeting our policy requirements.

  • PENDING - Indicates that the review decision is pending and WABA is currently unable to use our API.

  • DEFERRED - Indicates that the review decision has been delayed and WABA is currently unable to use our API.

whatsapp.business_account_capability.updated

Notifies you of changes to your WhatsApp Business account or business portfolio features (message limitsarrow-up-right, phone number capsarrow-up-right, etc.).

Example

Webhook payload structures

Key

Type

Description

max_phone_numbers_per_waba

int

The number of company phone numbers allowed per WABA is capped. This property is included only if max_daily_conversation_per_phone is not set to 250

max_daily_conversation_per_phone

int

This parameter will be removed in February 2026. Use max_daily_conversations_per_businessinstead.

max_daily_conversations_per_business

String

Message limitsarrow-up-right for the business portfolio.

  • TIER_250

  • TIER_2K

  • TIER_10K

  • TIER_10K

  • TIER_UNLIMITED

Last updated