# business_capability_update webhook reference | Developer Documentation

<div id="bkmrk-business_capability_">## business\_capability\_update webhook reference

<div><span>Updated: Nov 14, 2025</span></div><div>This reference describes trigger events and payload contents for the WhatsApp Business Account **business\_capability\_update** webhook.</div><div>The **business\_capability\_update** webhook notifies you of WhatsApp Business Account or business portfolio capability changes ([messaging limits](/books/meta-whatsapp/page/messaging-limits-developer-documentation), [phone number limits](/books/meta-whatsapp/page/business-phone-numbers-developer-documentation), etc.).</div><div id="bkmrk-triggers"><div id="bkmrk-triggers-1"><div>### Triggers

</div></div></div><span>A WhatsApp Business Account is created.</span><span>A WhatsApp Business Account or business portfolio business capability (e.g. [messaging limits](/books/meta-whatsapp/page/messaging-limits-developer-documentation), [phone number limits](/books/meta-whatsapp/page/business-phone-numbers-developer-documentation)) is increased or decreased.</span><div id="bkmrk-parameters"><div id="bkmrk-parameters-1"><div>### Parameters

</div></div></div><div><table><thead><tr><th><span>Placeholder </span></th><th><span>Description </span></th><th><span>Example value </span></th></tr></thead><tbody><tr><td><div><div>`<MAX_DAILY_CONVERSATIONS_PER_PHONE>`</div><div>*Integer*</div></div></td><td><div><div>**This parameter will be removed in February, 2026. Use `max_daily_conversations_per_business` instead.**</div><div>Business portfolio's [messaging limit](/books/meta-whatsapp/page/messaging-limits-developer-documentation). Values can be:</div><span>`250`</span><span>`2000`</span><span>`10000`</span><span>`100000`</span><span>`-1`</span><div>A value of `-1` indicates unlimited messaging.</div></div></td><td><div><div>`2000`</div></div></td></tr><tr><td><div><div>`<MAX_DAILY_CONVERSATIONS_PER_BUSINESS>`</div><div>*Integer*</div></div></td><td><div><div>Business portfolio's [messaging limit](/books/meta-whatsapp/page/messaging-limits-developer-documentation).</div><div>Value can be:</div><span>`TIER_250`</span><span>`TIER_2K`</span><span>`TIER_10K`</span><span>`TIER_100K`</span><span>`TIER_UNLIMITED`</span></div></td><td><div><div>`TIER_UNLIMITED`</div></div></td></tr><tr><td><div><div>`<MAX_PHONES_PER_BUSINESS_PORTFOLIO>`</div><div>*Integer*</div></div></td><td><div><div>Maximum number of business phone numbers the business portfolio can have.</div><div>This property is only included if `max_daily_conversation_per_phone` is set to `250`.</div></div></td><td><div><div>`2`</div></div></td></tr><tr><td><div><div>`<MAX_PHONES_PER_WHATSAPP_BUSINESS_ACCOUNT>`</div><div>*Integer*</div></div></td><td><div><div>Maximum number of business phone numbers allowed per WABA.</div><div>This property is only included if `max_daily_conversation_per_phone` is **not** set to `250`.</div></div></td><td><div><div>`25`</div></div></td></tr><tr><td><div><div>`<WEBHOOK_TRIGGER_TIMESTAMP>`</div><div>*Integer*</div></div></td><td><div><div>Unix timestamp indicating when the webhook was triggered.</div></div></td><td><div><div>`1739321024`</div></div></td></tr><tr><td><div><div>`<WHATSAPP_BUSINESS_ACCOUNT_ID>`</div><div>*String*</div></div></td><td><div><div>WhatsApp Business Account ID.</div></div></td><td><div><div>`102290129340398`</div></div></td></tr></tbody></table>

</div></div>