WhatsApp API Rate Limits Explained: How to Scale Without Getting Blocked
Messaging tiers, per-second throughput, and this API's own plan limits, explained separately. What actually triggers blocks or reduced delivery, and how to scale eCommerce, SaaS, and support sends safely.
Meta Description: WhatsApp API rate limits explained: messaging tiers, throughput, and the real triggers for blocks. Plus how to scale eCommerce, SaaS, and support sends without getting throttled.
Introduction
Your campaign is queued, your list is ready, and message 400 comes back with an error code instead of a delivery receipt. That's a rate limit, and it's the point where most teams first learn WhatsApp has more than one of them.
"WhatsApp API rate limits" actually covers three separate mechanisms: a daily cap on how many people you can message first, a per-second cap on how fast messages go out, and — if you're not on the official Business Platform — whatever limit sits on the API you're actually using. Mixing these up is how a team plans a launch around the wrong number and gets throttled halfway through.
This guide separates the three, explains what actually gets numbers blocked or throttled, and covers how to scale sends for eCommerce, SaaS, and support use cases without tripping any of them.
What "Rate Limit" Actually Means Here
Two different systems get lumped under "WhatsApp API rate limits," and they don't work the same way.
Messaging limits (volume). Meta's own messaging limits documentation defines this as the maximum number of unique phone numbers your business can message first, outside an existing conversation, in a rolling 24-hour window. Reply to someone who messaged you first and it doesn't count against this limit at all — you get a free 24-hour service window per conversation.
Throughput (speed). This is how fast messages go out once you're within your daily volume, measured in messages per second (MPS) at the phone number or WhatsApp Business Account (WABA) level. Hit it and Meta's Cloud API returns error 130429 — "message throughput has been reached" — not a ban, just a signal to slow down.
If you're sending through a session-based API instead of the official Business Platform — this product included — there's no messaging-tier system to climb, because there's no WABA or template queue underneath it. What you have instead is a plan-level rate limit and monthly request quota, plus the underlying WhatsApp network's own spam detection on the number itself. More on both below.
Daily Limits vs Messaging Tiers vs Per-Second Limits
The official tier ladder
Every new WhatsApp Business Account starts at the bottom and climbs based on usage and quality, not payment:
| Tier | Unique contacts / 24h |
|---|---|
| Starting tier | 250 |
| Tier 2 | 2,000 |
| Tier 3 | 10,000 |
| Tier 4 | 100,000 |
| Tier 5 | Unlimited |
You cannot pay Meta to skip a tier. Advancement is automatic once your quality rating stays healthy and you're consistently using a meaningful share of your current limit — under-using a tier is treated the same as not being ready for the next one.
Throughput is a separate number
A business on Tier 4 (100,000 contacts/day) can still be capped at a modest messages-per-second rate — daily volume and per-second speed are tracked independently. Sending 90,000 messages in the first hour of a 100,000-contact day is where teams hit error 130429 even though they're nowhere near their daily cap.
This product's rate limits, by plan
If you're on the session-based API instead, this is the number that actually governs your sends:
| Plan | Requests/mo | Sessions | Rate limit |
|---|---|---|---|
| Basic | 100 (hard limit) | 1 | 10 req/sec |
| Pro | 1,000 + overage | 3 | 10 req/sec |
| Ultra | 10,000 + overage | 10 | 20 req/sec |
| Mega | 50,000 + overage | Unlimited | 25 req/sec |
No quality-rating ladder to climb here — the rate limit is fixed per plan, and moving up is a plan upgrade, not a multi-day earn-in. That trade cuts both ways: faster to a higher ceiling, but no Tier 5 "unlimited" waiting at the top the way the official platform has one.
What Triggers Blocks or Reduced Delivery
Sending too fast gets you a throttle. Sending badly gets you blocked. Meta's own error codes make the distinction explicit:
- •130429 — Throughput limit reached. You're sending faster than your current MPS allows. Back off and retry.
- •131056 — Recipient rate limit. Too many messages to the same number in a short window — a common mistake when a retry loop doesn't check for duplicate sends.
- •131048 — Message quality throttling. Recent messages were blocked or flagged as spam by recipients, and Meta is restricting you until quality recovers.
- •80007 — Account rate limit. The WABA itself, not just one number, has hit its ceiling.
Underneath all of these is quality rating: a rolling score (Green, Yellow, Red) built from how many recipients block you, report you, or simply ignore you. A burst of blocks and reports in a short window is the single fastest way to drop from Green to Red, and a Red rating is what actually shrinks your messaging limit — the throughput and volume numbers above are the ceiling, quality rating is what decides whether you keep it.
The behaviors that get a number flagged, official API or not:
- •Messaging people who never opted in
- •A sudden volume spike on a cold or newly registered number
- •Marketing content sent under the wrong template category
- •Recycled or purchased contact lists
- •Ignoring low engagement — since delivery is now engagement-weighted, a list that doesn't open your messages quietly throttles your reach before you see a formal violation
None of this is specific to Meta's official infrastructure. A session-based number that blasts an unsegmented list at full speed on day one looks exactly like spam to WhatsApp's own network, tier system or not.
How to Increase Limits Safely
On the official Business Platform: keep quality rating at Green or Yellow, and use a consistent, meaningful share of your current tier rather than sending in occasional bursts — that combination is what triggers an automatic tier upgrade. There's no support ticket that skips this; it's earned through send behavior.
On a session-based API: there's no tier to earn — moving to a higher rate limit means moving to a higher plan. What you control is pacing within your current limit:
// Stay under a fixed per-second cap regardless of plan tier
async function sendBatch(numbers, message, session, requestsPerSecond = 10) {
const delayMs = Math.ceil(1000 / requestsPerSecond);
for (const [i, chatId] of numbers.entries()) {
await axios.post(
'https://whatsapp-messaging-bot.p.rapidapi.com/v1/sendText',
{ chatId, text: message, session },
{
headers: {
'x-rapidapi-key': process.env.RAPIDAPI_KEY,
'x-rapidapi-host': 'whatsapp-messaging-bot.p.rapidapi.com',
},
}
);
console.log(`Sent ${i + 1}/${numbers.length}`);
await new Promise((r) => setTimeout(r, delayMs));
}
}On either API:
- •Warm up new numbers with low, steady volume for the first 1-2 weeks instead of a full-list blast on day one
- •Segment lists so only opted-in, recently engaged contacts get marketing sends — WhatsApp Broadcast Marketing covers segmentation in more depth
- •Add exponential backoff on any 429-style error instead of retrying immediately
- •Monitor delivery and block/report rates as a leading indicator, not just total volume sent
Practical Examples
eCommerce — flash sale order confirmations. A sale that generates 2,000 orders in an hour isn't 2,000 simultaneous sends — it's a queue. Push confirmations onto a job queue (BullMQ, SQS, whatever you're already running) and drain it at your plan's req/sec limit instead of firing every confirmation the instant an order lands. The customer still gets their message in seconds, not the split second the order completed.
SaaS — OTP and auth spikes. Login spikes cluster at predictable times (Monday morning, post-outage recovery), and OTP messages are latency-sensitive in a way marketing sends aren't — a user waiting on a code notices a 3-second delay. Provision headroom above your average signup rate specifically for these spikes rather than sizing your plan to average load; see WhatsApp OTP Authentication for the full auth flow.
Support teams — inbound-triggered replies. This is the one case where rate limits mostly don't apply: if a customer messages first, your replies inside that 24-hour window don't count against messaging limits at all. A support team replying to inbound tickets is naturally safer than a marketing team pushing outbound campaigns — the constraint to watch instead is your own team's response-time SLA, not WhatsApp's throttle.
Checklist Before Sending at Scale
- •[ ] Confirmed which limit actually applies to you — official messaging tier, or this API's plan-level rate limit
- •[ ] Every recipient on the send list has explicit opt-in on file
- •[ ] New or recently re-activated numbers are warmed up with low volume first, not a full-list blast
- •[ ] Sends are queued and paced to your req/sec limit, not fired all at once
- •[ ] Retry logic backs off on 429/throughput errors instead of hammering the endpoint
- •[ ] Quality/delivery metrics are monitored, not just total messages sent
- •[ ] Marketing and transactional sends are segmented separately, so a marketing throttle never delays an OTP or order confirmation
Key Takeaways
- 1."Rate limit" is at least two different numbers — a daily cap on unique recipients (messaging tier) and a per-second cap on throughput, tracked independently.
- 2.Tier upgrades on the official platform are earned, not bought — consistent volume plus a healthy quality rating, not a bigger invoice.
- 3.A session-based API replaces the tier ladder with a plan-level rate limit — no multi-day earn-in, but also no free path past your plan's ceiling.
- 4.Blocks come from behavior, not volume alone — missing opt-in, cold-number spikes, and ignored messages drop quality rating faster than raw send count does.
- 5.Support replies inside an active 24-hour window are the safest kind of send — they don't count against messaging limits at all.
Related guides:
- •WhatsApp API Security & GDPR Compliance — rate limiting and abuse prevention as part of a full security checklist
- •WhatsApp Broadcast Marketing — segmentation and opt-in management for sends at volume
- •WhatsApp Business API Explained — how templates, tiers, and BSPs fit together on the official platform
External resources:
- •WhatsApp Business Platform Messaging Limits — Meta's own documentation on tier thresholds and how upgrades work
- •WhatsApp Cloud API Error Codes — the throughput, rate-limit, and quality-throttling codes referenced above, direct from Meta
- •WhatsApp Business Messaging Policy — the opt-in requirements that sit underneath every quality rating
Scale Without the Ladder
If you don't need the official platform's multi-agent tooling yet, a session-based API skips the tier system entirely — you get a fixed, predictable rate limit per plan instead of a ladder to climb.
Try Free on RapidAPI → Subscribe to Basic ($0) → Scan the QR code → Send your first batch, paced and opted-in from day one.
Ready to Get Started?
Try the WhatsApp API free on RapidAPI with no credit card required.
Try Free on RapidAPI