| Before Oct 7th, 2025 | Starting Oct 7th, 2025 | |
|---|---|---|
Where are limits set? | On individual business phone numbers. For example, phone number A could have a limit of 10K but phone number B could have a limit of 100K. | On individual business portfolios. For example, a portfolio with two business phone numbers could have a limit of 100K, and both phone numbers share the 100K limit. |
Starting limit for newly created business portfolios | Not applicable | 250 |
Starting limit for a newly registered number | 250 | Shares the messaging limit set on the business portfolio. |
Limit upon becoming eligible for automatic scaling | 1,000 | 2,000 |
Time to increase limit via automatic scaling | Limit increased 24 hours after meeting criteria. | Limit increased 6 hours after meeting criteria. |
Phone number quality states | The Flagged phone number quality state is possible. If your business phone number quality rating has been set to Flagged for the last 7 days, we will decrease its limit by one level, immediately. | The Flagged phone number quality state is no longer possible. If your business phone number quality rating drops, its messaging limit will not be downgraded. |
Automatic scaling criteria |
|
|
Webhooks | business_capability_update webhook:
phone_number_quality_update webhook:
| business_capability_update webhook:
phone_number_quality_update webhook:
|
Throughput eligibility requirements | For a business phone number to become eligible for 1,000 messages per second:
| For a business phone number to become eligible for 1,000 messages per second:
If you meet our eligibility requirements, we will automatically upgrade your business phone number to 1,000 mps within 12 hours. |
Endpoints | To get a business phone number’s current messaging limit, request the messaging_limit_tier field on the business phone number. | To get a business portfolio’s current messaging limit, request the (new) whatsapp_business_manager_messaging_limit field on the business portfolio, or a WhatsApp Business Account or business phone number within the portfolio.You can request this field directly on any of these resources, or indirectly using field expansion with any endpoints that return business portfolios, WhatsApp Business Accounts, or business phone numbers. |

