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.
<EVENT>	String	WhatsApp Business account (" WABA ") event. ACCOUNT_VIOLATION - Indicates that WABA has violated one of our policies or terms. 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 rates. 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 terms. 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 provider. 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 verifies that a submission has been approved, rejected, or deprecated. PARTNER_REMOVED - Indicates that the WABA shared with the solution provider 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 violation. 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

{
    "eventId": "evt.2011278700162580480",
    "wabaId": "12334667553220443",
    "apiVersion": "v1.0",
    "type": "whatsapp.business_account.alerted",
    "value": {
        "entity_type": "BUSINESS",
        "entity_id": "506914307656634",
        "alert_info": {
            "alert_status": "ACTIVE",
            "alert_description": "Limits cannot be increased for your business <BUSINESS_PORTFOLIO_NAME>. Use WhatsApp Business platform actively for several days and follow our messaging policies.",
            "alert_severity": "WARNING",
            "alert_type": "INCREASED_CAPABILITIES_ELIGIBILITY_DEFERRED"
        }
    }
}

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

{
    "eventId": "evt.2011281692697821184",
    "wabaId": "1233465748220443",
    "apiVersion": "v1.0",
    "type": "whatsapp.business_account.deleted",
    "value": {
        "event": "ACCOUNT_DELETED"
    }
}

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

{
    "eventId": "evt.2011282226997624832",
    "wabaId": "123346648220447",
    "apiVersion": "v1.0",
    "type": "whatsapp.business_account.reviewed",
    "value": {
        "decision": "APPROVED"
    }
}

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 limits, phone number caps, etc.).

Example

{
    "eventId": "evt.2011284694858989568",
    "wabaId": "1233466748220443",
    "apiVersion": "v1.0",
    "type": "whatsapp.business_account_capability.updated",
    "value": {
        "max_phone_numbers_per_waba": 25,
        "max_daily_conversation_per_phone": 10000,
        "max_daily_conversations_per_business": "TIER_10K"
    }
}

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 limits for the business portfolio. TIER_250 TIER_2K TIER_10K TIER_10K TIER_UNLIMITED