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, conforming to the API Commons Rate Limits specification.

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

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 Throttle: 429
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