> ## Documentation Index
> Fetch the complete documentation index at: https://knowledge.flowella.io/llms.txt
> Use this file to discover all available pages before exploring further.

# WhatsApp messaging limits: tiers and how to increase them

> Understand Meta's WhatsApp messaging limits, how portfolio tiers scale from 250 to unlimited, how to reach 2,000, and how to avoid hitting the cap.

Meta caps how many **unique WhatsApp user phone numbers** your business can deliver messages to **outside** a customer service window, within a moving 24-hour period. These caps are **messaging limits**.

Meta calculates and sets limits at the **business portfolio** level, and **every business phone number** in the portfolio shares them. One busy number can use up the whole portfolio's limit for the day.

This page summarises Meta's rules, what you see in Flowella, and how limits relate to the [quality rating](https://knowledge.flowella.io/whatsapp/limits/quality-score.md) and delivery errors such as [131048](https://knowledge.flowella.io/whatsapp/errors/error-131048.md).

> [!NOTE]
>
> **In Flowella.** Meta applies the limit to every message Flowella sends for you, and there is nothing to set up. Flowella doesn't show your limit or how much of it you've used, and it doesn't hold sends back to stay under it. Check the limit in WhatsApp Manager. See [In Flowella](#in-flowella).

> [!NOTE]
>
> Official reference: Meta's [messaging limits](https://developers.facebook.com/documentation/business-messaging/whatsapp/messaging-limits) page. The older per-number `messaging_limit_tier` field is deprecated; Meta documents `whatsapp_business_manager_messaging_limit` instead.

## Portfolio messaging limit tiers

New business portfolios start at **250** unique recipients in a moving 24-hour period. Meta can raise the portfolio limit to:

| Limit | How you typically reach it |
| - | - |
| **250** | Default for a new business portfolio |
| **2,000** | Complete one of the [scaling paths](#how-to-increase-to-2000) |
| **10,000** | [Automatic scaling](#automatic-scaling-after-2000) after 2,000 |
| **100,000** | Automatic scaling |
| **Unlimited** | Automatic scaling |

"Unique recipients" means distinct WhatsApp user phone numbers you deliver to outside an open customer service window. Messaging the same person twice in the 24-hour period still counts as **one** unique recipient.

## What counts towards the limit

Messaging limits apply to deliveries **outside** a customer service window. When a customer has messaged your business and their 24-hour window is open, your replies in that window don't count towards the portfolio limit.

For campaign planning:

* Nurture and broadcast templates to people who haven't messaged you recently **do** count.
* Replies **inside** an open window, whether from the Inbox, the HubSpot inbox or the Customer Agent, **don't** count.

Separately, Meta can still block individual marketing messages with [error 131049](https://knowledge.flowella.io/whatsapp/limits/per-user-marketing-limit.md), a per-user marketing limit. That is **not** the same as your portfolio messaging limit.

## How to increase to 2,000

Meta documents three scaling paths from 250 to **2,000**. Complete any one of them:

1. **Verify your business** with Meta. See [Business verification](https://knowledge.flowella.io/whatsapp/accounts/business-verification.md).
2. **Have your partner verify your business**, if a partner onboarded you and offers partner-led verification.
3. **Send 2,000 delivered messages** outside customer service windows to unique WhatsApp users within a **30-day** moving period, using templates with a **high** [template quality rating](https://knowledge.flowella.io/whatsapp/limits/quality-score.md#template-quality-rating).

Once you complete a path, Meta analyses your message quality and decides whether the portfolio can move up.

* **Approved:** the limit moves to 2,000 straight away. Meta tells you by email and developer alert, and sends a `business_capability_update` webhook with `max_daily_conversations_per_business` set to the new limit.
* **Declined:** the limit stays where it is. Meta tells you by email and developer alert, and sends an `account_alerts` webhook whose `alert_type` says what to try next.

| `alert_type` | What to do next |
| - | - |
| `INCREASED_CAPABILITIES_ELIGIBILITY_DEFERRED` | Send 2,000 delivered messages to unique people outside customer service windows within 30 days, using high-quality templates. |
| `INCREASED_CAPABILITIES_ELIGIBILITY_FAILED` | The same as above. |
| `INCREASED_CAPABILITIES_ELIGIBILITY_NEED_MORE_INFO` | [Verify your identity](https://www.facebook.com/business/help/587323819101032) with Meta, or send the 2,000 high-quality messages. |

Flowella doesn't notify you when your limit goes up or a request is declined. Watch for Meta's email, or check WhatsApp Manager.

## Automatic scaling after 2,000

Once the portfolio is at 2,000, Meta raises the limit by one level when **both** are true:

* You're sending **high-quality messages** across your business phone numbers and templates.
* In the last **7 days**, your business has used **at least half** of its current limit.

When both criteria are met, Meta raises the limit by one level within about **6 hours**.

Poor [number or template quality](https://knowledge.flowella.io/whatsapp/limits/quality-score.md) slows or blocks scaling. A lower quality rating doesn't **reduce** a limit you already have, though. [Error 131048](https://knowledge.flowella.io/whatsapp/errors/error-131048.md) is a related signal that Meta has restricted sends from your number for spam or quality reasons.

## What changed on 7 October 2025

Before 7 October 2025, Meta set a separate limit for each phone number. Since then, the limit belongs to the business portfolio.

| | Before 7 October 2025 | Since 7 October 2025 |
| - | - | - |
| Where the limit is set | Each phone number | The business portfolio, shared by all its numbers |
| Existing portfolios | Not applicable | Took the highest limit of any number in the portfolio |
| A newly registered number | Started at 250 | Gets the portfolio's limit straight away |
| First step after the scaling path | 1,000 | 2,000 |
| Time to scale up | 24 hours after meeting the criteria | About 6 hours |
| Effect of a quality drop | A number **Flagged** for 7 days dropped one level | The **Flagged** state no longer exists. A quality drop doesn't lower the limit |

This is why adding another number to the same portfolio doesn't give you more capacity, and why a new number can send at the portfolio's full limit from its first day.

## Checking your limit

### In WhatsApp Manager

Meta shows your current messaging limit in WhatsApp Manager → **Account tools** → **Messaging limits**.

### Via API

Request `whatsapp_business_manager_messaging_limit` on the business portfolio, the WhatsApp Business Account or any of its phone numbers (values look like `TIER_250`). Don't rely on the deprecated `messaging_limit_tier` field.

### In Flowella

Flowella doesn't show your messaging limit or how much of it you've used, so check the limit in WhatsApp Manager. Flowella shows what happens when sends fail:

* **Failed messages:** the [Inbox](https://knowledge.flowella.io/app/inbox.md) marks a message **Failed** and prints the reason Meta gave under it. Bulk send jobs count failed messages in the job summary. See [Bulk send](https://knowledge.flowella.io/app/bulk-send.md).
* **Dashboard:** the attention strip shows **Delivery failures** when more than 5% of the selected number's outbound messages failed in the last 7 days. See [Dashboard](https://knowledge.flowella.io/app/dashboard.md#attention-strip).
* **Results:** delivery, read and failure rates for any date range. See [Results](https://knowledge.flowella.io/app/analytics.md#delivery-read-and-failure-rates).

Flowella doesn't pause sends to stay under Meta's limit. Once you reach it, Meta rejects further messages and they show as failed. Send the rest after the moving 24-hour period frees up capacity. See [Messages not delivered](https://knowledge.flowella.io/troubleshooting/messages-not-delivered.md).

## How to avoid hitting the limit mid-campaign

> [accordion] Plan volume around the portfolio limit
>
> Before a large send, check your current limit in WhatsApp Manager. If the list is bigger than the limit:
>
> * Spread the send across several days so each 24-hour period stays under the limit. [Bulk send](https://knowledge.flowella.io/app/bulk-send.md) lets you schedule jobs for later.
> * Trim the list to engaged, opted-in recipients.
> * Remember that every number in the **same** portfolio shares one limit. Adding another number to the same portfolio does **not** double it.

> [accordion] Warm up gradually and protect quality
>
> A new portfolio starts at 250 with little quality history. Sending to a cold list on day one risks a Yellow or Red quality rating and stalls the path to 2,000. Start with smaller daily volumes to recently opted-in contacts. See [Quality rating](https://knowledge.flowella.io/whatsapp/limits/quality-score.md).

> [accordion] Use verification as a scaling path
>
> Completing [business verification](https://knowledge.flowella.io/whatsapp/accounts/business-verification.md) is one of Meta's documented paths to the 2,000 limit, alongside partner-led verification and high-quality volume. Verification also supports broader trust signals Meta uses for higher tiers.

> [accordion] Tell portfolio limits apart from 131049
>
> If marketing templates fail with "healthy ecosystem engagement", that is usually [131049](https://knowledge.flowella.io/whatsapp/limits/per-user-marketing-limit.md), a per-user marketing limit, not your portfolio limit. Wait before you send that person another marketing message, and don't retry repeatedly.

## Throughput is different

Messaging limits (unique recipients in 24 hours) are **not** the same as **throughput** (messages per second). Each number can send up to 80 messages per second by default, and numbers that use [co-existence](https://knowledge.flowella.io/whatsapp/accounts/co-existence.md) are fixed at 20. See [Throughput](https://knowledge.flowella.io/whatsapp/limits/throughput.md).

## Related guides

* [Throughput](https://knowledge.flowella.io/whatsapp/limits/throughput.md): messages per second and the pair rate limit
* [Template pacing and pausing](https://knowledge.flowella.io/whatsapp/limits/template-pacing-and-pausing.md): held and paused templates
* [Quality rating](https://knowledge.flowella.io/whatsapp/limits/quality-score.md): number and template quality that affects scaling
* [Error 131048](https://knowledge.flowella.io/whatsapp/errors/error-131048.md): spam or quality restrictions on your number
* [Error 131049](https://knowledge.flowella.io/whatsapp/limits/per-user-marketing-limit.md): the per-user marketing limit
* [Messages not delivered](https://knowledge.flowella.io/troubleshooting/messages-not-delivered.md): broader delivery troubleshooting
* [Business verification](https://knowledge.flowella.io/whatsapp/accounts/business-verification.md): verification as a scaling path
* [Bulk send](https://knowledge.flowella.io/app/bulk-send.md): schedule large sends across days
* [Campaigns overview](https://knowledge.flowella.io/campaigns/overview.md): plan outbound volume around your limit

Checked against Meta's documentation on 18 November 2026: [Messaging limits](https://developers.facebook.com/documentation/business-messaging/whatsapp/messaging-limits) and [Changes to messaging limits](https://developers.facebook.com/documentation/business-messaging/whatsapp/upcoming-messaging-limits-changes).


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.