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

            
        
        
        
    
        

    
        

    
    
        
        
        
             Back to top