business_capability_update webhook reference

Updated: May 21, 2026

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.
• A WhatsApp Business account or business portfolio business capability (for example, messaging limits, phone number limits) is increased or decreased.

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"  
}