The 250-Contact Limit on the WhatsApp Business API: How It Works and How to Raise It

You are planning your first campaign with a newly opened WhatsApp Business API account, and the list has 3,000 customers. Sending starts, and at some point messages stop being delivered. The problem is often not the template or the provider, but the starting limit Meta applies to new accounts. In this article, based on Meta's developer documentation, we explain what the limit counts, how it is raised, and how to plan your campaign accordingly.

Short Answer

According to Meta's documentation, newly created business portfolios start at 250. This number is not messages but the number of unique people you can reach in a rolling 24-hour period outside the customer service window. There are three ways to reach 2,000: business verification, verification through a partner, or delivering messages with high-quality templates to 2,000 unique numbers within 30 days. Beyond 2,000, the limit increases automatically depending on quality.

What does the limit count?

This is where the first confusion arises. Meta defines the limit as “the number of unique WhatsApp phone numbers you can message outside the customer service window in a rolling 24-hour period.” Two things stand out.

First, what is counted is people. Sending the same customer three templates in one day uses up one person of your limit. Second, the “rolling” 24 hours: there is no calendar day that resets at midnight; at any moment the last 24 hours are looked at retroactively. If you sent to 250 people at 09:00 in the morning, you cannot send a template to a new person until 09:00 the next day.

The limit applies to messages outside the window. Meta's limit page does not separately state how replies you make while the 24-hour window is open, in chats where the customer wrote to you, are affected by the limit. Rather than state anything definitively, I recommend observing this in your provider's dashboard or in Meta's account tools.

The limit is now at portfolio level

According to Meta's documentation, limits are applied at the business portfolio level, and all business numbers in the same portfolio share the same limit. The documentation's warning is clear: a single number can consume the portfolio's entire capacity.

In practice, this means the following. If a company has three separate WhatsApp numbers for sales, support and appointments, they all draw from the same pool. A bulk send by the sales team in the morning can cause appointment reminders not to go out in the afternoon. Separating numbers does not separate the limit.

Tiers: 250, 2,000, 10,000 and Beyond

The tiers on Meta's current page are as follows: 250 for a new portfolio, 2,000 after completing one scaling path, then 10,000, 100,000 and unlimited through automatic scaling. A noteworthy detail: some provider help pages and older guides mention an intermediate tier of 1,000. There is no such tier in Meta's current documentation. If you are calculating from an older guide, check the value in your own dashboard.

There are three ways to go from 250 to 2,000:

• Verify your business. The process in which Meta reviews your legal company information and documents.
• Have your partner verify. If you opened the account through a provider that is a Meta business partner (BSP), the partner that handled onboarding can complete the verification on your behalf.
• Earn it through use. Deliver messages to 2,000 unique numbers within a rolling 30-day period, outside the window, using high-quality templates.

After you complete the path, no automatic upgrade follows: Meta reviews your message quality and either approves or rejects eligibility. If approved, the limit becomes 2,000 immediately. If rejected, the limit stays the same and the account_alerts webhook suggests another path, for example identity verification.

Beyond 2,000, scaling is automatic. There are two conditions: sending high-quality messages across all numbers and templates, and using at least half of your current limit in the last 7 days. If both are met, according to Meta the limit moves up one tier within 6 hours.

Which path suits you?

Verification is the most predictable path for companies whose documents are ready and whose legal details are consistent, because it unlocks 2,000 without needing any sending volume. I could not confirm from official pages which document types Meta accepts for Turkey or how long the review takes, so I am not giving a document list or a number of days here. See Meta's verification help page and your provider's Turkey guide. The warning that appears most often in providers' help pages is that the company name and address in the Meta account must match the document exactly. Read this not as a Meta rule but as a secondhand note.

The third path suits businesses that don't want to deal with verification but have regular customer communication. The logic is reversed: you start with a small list, protect template quality, and reach 2,000 unique people in 30 days. If your list is smaller than 2,000, this path is closed anyway.

Planning the campaign around the 250 limit

While waiting for verification you have 250. Instead of sending a 3,000-person list in one go, you need to prioritize the list: people who have messaged you or purchased in the last 90 days go first, those who have been silent for a long time go last. If complaint and block rates stay low in the first sends, your quality signal also starts clean, and that helps with later tiers.

With a tool like n8n you can build a simple queue: every day it pulls as many people as will stay under the limit, sends, and writes to a table who it went to. Because the limit is a rolling 24 hours, it is safer to run the queue "at the same time every day" and not use the whole limit. Leave the remaining share for templates triggered by the customer: order notifications, appointment reminders, one-time codes.

You might also consider separating the number from the campaign, but since the limit is at portfolio level, this separates only reporting, not capacity.

How to check your current limit

According to Meta's documentation there are two places. The first is the Messaging limits panel under Account tools in WhatsApp Manager. The second is the API: querying the whatsapp_business_manager_messaging_limit field on the phone number; the sample response returns TIER_250. The old messaging_limit_tier field has been deprecated. If you are building automation, checking this field before sending and wiring it into the campaign flow prevents silent failures. Listening to account_alerts events in the same flow also lets you see a rejection the same day.

Provider dashboards may pull this value at different intervals. If the numbers don't match, treat the one on Meta's side as authoritative.

Protecting quality matters as much as the limit itself

Both the 2,000 path and the later automatic increases depend on the "high quality" requirement. Meta's limit page doesn't explain how the quality score is calculated, so I won't guess at the criteria. What you do have that is concrete is the account_alerts notification that arrives on rejection: there Meta tells you which other path it suggests. If you were rejected, reading this notification and following the suggested path is more productive than retrying the same send.

There is a legal side too. Sending the first message with a template to people who have not given consent is not only a quality matter but also a KVKK matter. The checkpoints in the KVKK-compliant automation article apply here as well. Don't forget the cost side either: marketing templates are always paid, so raising the limit is also a decision to raise the bill. To work out the numbers, see our cost and return article.

A five-minute check before the campaign

1. Check your portfolio's current limit in the Messaging limits panel; don't rely on the number in the provider dashboard.
2. Find out whether another number or team in the same portfolio is sending.
3. Count the unique numbers in the list. If the same person appears in two records, it makes the total look larger than it really is.
4. Check whether your verification request is open, pending, or rejected.
5. Don't allocate more than half of the limit to the campaign; leave room for notifications triggered by the customer.

FAQ

Sources: Meta for Developers, "Messaging Limits". Tiers and conditions may be changed by Meta; for the current value, check the Messaging limits panel in your account.