WhatsApp Business Platform

business_capability_update webhook reference

Updated: May 21, 2026
Copy for LLM
This reference describes trigger events and payload contents for the WhatsApp Business account business_capability_update webhook.
The business_capability_update webhook notifies you of WhatsApp Business Account or business portfolio capability changes (messaging limits, phone number limits, etc.).

Triggers

  • A WhatsApp Business account is created.

Syntax

{
  "entry": [
    {
      "id": "<WHATSAPP_BUSINESS_ACCOUNT_ID>",
      "time": <WEBHOOK_TRIGGER_TIMESTAMP>,
      "changes": [
        {
          "value": {
            "max_daily_conversation_per_phone": <MAX_DAILY_CONVERSATIONS_PER_PHONE>,
            "max_daily_conversations_per_business": <MAX_DAILY_CONVERSATIONS_PER_BUSINESS>,
            "max_phone_numbers_per_business": <MAX_PHONES_PER_BUSINESS_PORTFOLIO>,
            "max_phone_numbers_per_waba": <MAX_PHONES_PER_WHATSAPP_BUSINESS_ACCOUNT>
          },
          "field": "business_capability_update"
        }
      ]
    }
  ],
  "object": "whatsapp_business_account"
}

Parameters

Placeholder Description Example value
<MAX_DAILY_CONVERSATIONS_PER_PHONE>
Integer
This parameter will be removed in February, 2026. Use max_daily_conversations_per_business instead.
Business portfolio’s messaging limit. Values can be:
  • 250
  • 2000
  • 10000
  • 100000
  • -1
A value of -1 indicates unlimited messaging.
2000
<MAX_DAILY_CONVERSATIONS_PER_BUSINESS>
Integer
Business portfolio’s messaging limit.
Value can be:
  • TIER_250
  • TIER_2K
  • TIER_10K
  • TIER_100K
  • TIER_UNLIMITED
TIER_UNLIMITED
<MAX_PHONES_PER_BUSINESS_PORTFOLIO>
Integer
Maximum number of business phone numbers the business portfolio can have.
This property is only included if max_daily_conversation_per_phone is set to 250.
2
<MAX_PHONES_PER_WHATSAPP_BUSINESS_ACCOUNT>
Integer
Maximum number of business phone numbers allowed per WABA.
This property is only included if max_daily_conversation_per_phone is not set to 250.
25
<WEBHOOK_TRIGGER_TIMESTAMP>
Integer
Unix timestamp indicating when the webhook was triggered.
1739321024
<WHATSAPP_BUSINESS_ACCOUNT_ID>
String
WhatsApp Business Account ID.
102290129340398

Payload example

{
  "entry": [
    {
      "id": "524126980791429",
      "time": 1739321024,
      "changes": [
        {
          "value": {
            "max_daily_conversations_per_business": 2000,
            "max_phone_numbers_per_waba": 25
          },
          "field": "business_capability_update"
        }
      ]
    }
  ],
  "object": "whatsapp_business_account"
}