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.

    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

        

        
    
                
        
    
        

            
        
        
        
    
        

    
        

    
    
        
        
        
             Back to top