WhatsApp · Rate Limits

Whatsapp Rate Limits

WhatsApp Business Platform layers two distinct sets of limits. (1) Messaging Limits / Tiers cap the number of unique users a business can start business-initiated conversations with in a rolling 24-hour window; tiers progress (1K, 10K, 100K, Unlimited) based on phone-number quality rating and message volume. (2) Capacity / API rate limits govern raw request throughput on the Graph API and Cloud API endpoints. Both layers are scoped to the WhatsApp Business Account / phone number, not to per-user keys.

Whatsapp Rate Limits is the machine-readable rate-limit profile for WhatsApp on the APIs.io network, in the API Commons Rate Limits shape.

It captures 6 rate-limit definitions, measuring business_initiated_conversations_per_unique_user, requests_per_second, and varies.

Limit state is signalled in the retryAfter and requestId response headers, and an exhausted limit returns HTTP 429.

This profile was written by API Evangelist and has not been verified against a page the provider published; treat every limit as unconfirmed until a dated transcription replaces it.

The profile also includes 5 backoff/retry policies defined and response codes documented for throttled, rateLimited, and serviceUnavailable.

Tagged areas include Messaging, Rate Limiting, Messaging Tiers, and Quality Rating.

6 Limits Exhausted: HTTP 429 retryAfterrequestId
Method: generated, dated 2026-05-05.
Written by API Evangelist on 2026-05-05 and not verified against a page the provider published. Treat every limit as unconfirmed until a dated transcription replaces it.
View Source
MessagingRate LimitingMessaging TiersQuality Rating

Limits

Messaging Tier 1 phone-number
business_initiated_conversations_per_unique_user · day
1000
Default starting tier - up to 1,000 unique recipients per rolling 24h for business-initiated conversations. Quality rating must remain Medium or High to advance.
Messaging Tier 2 phone-number
business_initiated_conversations_per_unique_user · day
10000
Earned by reaching tier-1 cap with healthy quality.
Messaging Tier 3 phone-number
business_initiated_conversations_per_unique_user · day
100000
Earned by reaching tier-2 cap with healthy quality.
Messaging Tier Unlimited phone-number
business_initiated_conversations_per_unique_user · day
-1
Unlimited unique-recipient conversations per 24h once a phone number qualifies.
Cloud API Capacity Rate Limit phone-number
requests_per_second
see Cloud API capacity rate limits doc (varies by phone-number throughput)
Cloud API enforces a per-phone-number request-throughput limit; Meta scales it based on observed traffic and quality. Returns 429 / error code 80007 on throttle.
Graph API Application Rate Limit app
varies
see Graph API rate-limiting headers (X-App-Usage / X-Business-Use-Case-Usage)
Standard Graph API throttle applies to Business Management / Account Management / Flows endpoints; clients must inspect X-App-Usage and X-Business-Use-Case-Usage headers.

Policies

Quality Rating
Phone-number quality rating (Green / Yellow / Red) gates messaging-tier progression and can demote a number; user blocks and low-engagement messages drag rating down.
Tier Progression
To move up a messaging tier, a phone number must hit the prior tier's cap within a 7-day window while keeping quality at Medium or High. Demotion happens automatically on poor quality.
Conversation Window
A user-initiated 24-hour service window allows free-form messages; outside the window, only approved templates send (and open paid conversations).
Backoff
Honor Retry-After on 429. Inspect X-App-Usage / X-Business-Use-Case-Usage to back off proactively before being throttled. Apply exponential backoff with jitter on 5xx.
Resource Scoping
Limits attach to the WhatsApp Business Account (WABA) and phone number; rotating access tokens does not raise limits.

Sources

Work with this as data

Every rate limit here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for rate limits

4 MCP tools reach this
  • find_rate_limitsBrowse and filter every rate limit in the catalog.
  • apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
  • resolveTurn a domain, URL or GitHub org into the provider it belongs to.
  • find_cohortsEvery scored population of providers in the catalog.
All 92 tools →

Call it yourself

curl for this page
This rate limit 
curl "https://apis.io/api/v1/rate-limits/whatsapp-rate-limits"
All rate limits 
curl "https://apis.io/api/v1/rate-limits?limit=25"

Discovery needs no key. Ratings and market analysis are Pro.

Get an API key

Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.

GitHub Google LinkedIn

A second provider on the same verified email joins the account you already have.