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`