Skip to main content

business_capability_update webhook reference | Developer Documentation

business_capability_update webhook reference

Updated: Nov 14, 2025
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 (e.g. 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:
      250200010000100000-1
      A value of -1 indicates unlimited messaging.
      2000
      <MAX_DAILY_CONVERSATIONS_PER_BUSINESS>
      Integer
      Business portfolio’s messaging limit.
      Value can be:
        TIER_250TIER_2KTIER_10KTIER_100KTIER_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"
        }
        
    
                
        
        
        
    
        
        
        
            
        
                
                
        
                    
                    
                
        
            
        
            
            
        
                                            
        
        
        
    
        

    

        
    
        

    
            
        
            
        

    
        
        
        
            
            
        
        
            
        

    
        
        
        
                    
        

        
        No comments to display
        

            
        

    

    

                    
        
        
        
                
        
        
        
    
        

    
        

    
    
        
        
        
             Back to top