WhatsApp Cloud API (Meta)
"The Cloud API, hosted by Meta, allows you to implement WhatsApp Business APIs without the cost of hosting your own servers and also allows you to more easily scale your business messaging." [1]
WhatsApp Cloud API is Meta's hosted REST API for sending and receiving WhatsApp messages at scale, covering customer support, marketing broadcasts, OTP authentication, conversational commerce, and interactive flows, without requiring businesses to run their own servers. Pricing is per message and usage-based with published rates; service conversations initiated by users are free with no volume cap as of November 2024. The API is self-serve, available globally (with a short list of sanctioned-region exclusions), and holds SOC 2 Type 2, ISO 27001, and GDPR certifications. New numbers start at 250 unique users per 24 hours and can scale to unlimited throughput, though all outbound template messages require prior WhatsApp approval and opt-in from recipients.
Best for / Avoid if
Best for: AI agents and automation - an agent-ready surface (MCP / llms.txt); Teams needing broad API coverage out of the box
Avoid if: You want to try it free before paying
Scores
- 45 / 100Agent friendliness
- 60 / 100Pricing transparency
- 65 / 100Setup speed
- 25 / 100Docs quality
- 75 / 100Procurement ease
- 55 / 100Trust readiness
Pricing & procurement
- Pricing model
- Usage-based
- Published pricing
- ✓ Yes
- Free tier
- ✗ No
- Free tier details
- No $0 platform plan exists - Meta charges only per delivered template message. Service conversations (user-initiated, replied within 24-hour customer service window) are free and unlimited for all businesses effective November 1, 2024 (the former cap of 1,000 free service conversations/month was removed). Utility template messages sent within an open customer service window are also free. All non-template (session) messages are free within the 24-hour window. Messages sent within a 72-hour free entry point window (from Click to WhatsApp Ads or Facebook Page CTA) are free across all template types. Access to the Cloud API infrastructure itself carries no platform fee.
- Self-serve signup
- ✓ Yes [2]
- Requires sales call
- ✗ No
- Enterprise plan
- ✗ No
| Plan | Item | Per | Amount | Source |
|---|---|---|---|---|
| WhatsApp Cloud API | platform fee | month | $0 | source |
| WhatsApp Cloud API | marketing template message delivered (US rate, per-message billing effective July 1 2025) | message | $0.025 | source |
| WhatsApp Cloud API | utility template message delivered — proactive (US rate) | message | $0.004 | source |
| WhatsApp Cloud API | authentication template message delivered (US rate) | message | $0.004 | source |
| WhatsApp Cloud API | utility template message sent within open 24-hour customer service window | message | $0 | source |
| WhatsApp Cloud API | service message (non-template, customer-initiated, within 24-hour window) | message | $0 | source |
| WhatsApp Cloud API — Click-to-WhatsApp / Facebook Page CTA entry point | all messages within 72-hour free entry-point window (all template types) | message | $0 | source |
Capabilities
- Supported actions
- send_template_message, send_session_message, send_text, send_media (image, audio, video, document, sticker), send_interactive_buttons, send_interactive_list, send_interactive_flow, send_product_message, send_catalog_message, send_location, send_contacts, send_reaction, send_call_permission_request, inbound_webhooks, message_status_callbacks, template_management (create, modify, bulk), phone_number_registration, phone_number_management, whatsapp_flows, catalog_products, payments_api (Brazil, India payment gateway), conversion_measurement, click_event_tracking, deep_linking, typing_indicators, read_receipts, group_management, business_account_management
- Regions
- global (businesses in Cuba, Iran, North Korea, Syria, Crimea, Donetsk, Luhansk are not eligible), Türkiye re-enabled as of May 15 2024, local data storage options available for data residency control, Meta data centers with multi-region disaster recovery
- Input types
- text, template, image, audio, video, document, sticker, interactive buttons, interactive list, interactive flow, product, catalog, location, contacts, reaction
- Output types
- message_status (accepted / held_for_quality_assessment / paused), delivered status, read receipts, inbound message webhook, message status and pricing notification webhook, account status change webhook, template quality score change webhook, conversation analytics, conversion measurement events, flow completion webhooks, payment status updates (via webhook)
- Webhooks
- ✓ Yes [3]
- Sandbox / test mode
- ✓ Yes [4]
- SDK languages
- Node.js [5]
- MCP server
- ✗ No [6]
Trust & compliance
- SOC 2
- SOC 2 Type II [7]
- HIPAA
- ✗ No [8]
- GDPR
- ✓ Yes [9]
- ISO 27001
- ✓ Yes [10]
- PCI DSS
- – Unknown
- Published SLA
- ✗ No [11]
- Rate limits
- New business phone numbers default to 250 unique users/24 hours; scales through tiers: 250 → 1,000 → 10,000 → 100,000 → unlimited unique users per 24-hour moving window. Throughput: up to 1,000 messages/second (Cloud API). Per-user rate: 1 message per 6 seconds to the same WhatsApp user. Quality rating (Green/Yellow/Red) gates tier advancement; Yellow freezes tier, Red can cut limit or pause number. [12]
- Known restrictions
- Requires Meta Business Account (WABA) setup and phone number registration before sending, Business-initiated messages outside the 24-hour customer service window must use pre-approved Message Templates, All message templates must be approved by WhatsApp before use; WhatsApp reserves the right to review, approve, pause, or reject any template, Opt-in required: businesses can only send messages to users who have opted in, Businesses in Cuba, Iran, North Korea, Syria, Crimea, Donetsk, and Luhansk are not eligible, Business Verification required to unlock higher messaging tiers and Official Business Account status, Quality rating (based on block/report rates) controls messaging tier; low quality can reduce or pause messaging capability, Per-user marketing template message limits apply (per-user frequency capping), 24-hour customer service window governs free-form messaging; only templates allowed outside window, No commercially available SLA for uptime or latency (99.9% uptime and <5s p99 latency documented as consistent performance, not contractual), The official Node.js SDK is archived (read-only) since June 2023; no official replacement SDK exists, Charges apply only when a template message is delivered (per-message billing effective July 1, 2025)
Developer surface
Integration
- API style
- rest
- Base URL
- https://graph.facebook.com
- Version
- v21.0
- Versioning
- url
- Stability
- ga
- Auth methods
- oauth2, api_key
- Idempotency keys
- ✗ No
- Error format
- vendor-specific
- Webhook signing
- X-Hub-Signature-256
- Rate limit
- 80 / second
- Node.js
whatsapp· repo
Adoption & maturity
- Launched
- 2021-11-01
- GA
- 2022-05-19
- Notable customers
- BMW, KLM Royal Dutch Airlines, Vodafone, iFood, Bank Mandiri, Iberia Airlines, Itau Brazil, Coppel
Other WhatsApp Business APIs
Twilio WhatsApp Business API
"Enable businesses to engage customers through WhatsApp messaging and calling via programmable APIs" connecting "3+ billion users on the world's most popular messaging app"
Bird WhatsApp API (MessageBird)
"Engage customers worldwide with WhatsApp API" - Bird connects marketing, service, and operations teams with customers on the world's most popular messaging app through rich message templates, interactive elements, product catalogs, and one-click payments via a unified API platform.
Vonage Messages API (WhatsApp)
"The Vonage Messages API integrates with SMS, MMS, RCS, WhatsApp, Messenger, Viber, and Email allowing you to communicate with your customers on the channels they like." - Vonage Messages API enables businesses to send and receive WhatsApp messages via a unified multichannel messaging platform.
Infobip WhatsApp Business API
"Meta-authorized partner that provides businesses with secure access to WhatsApp's messaging infrastructure, enabling secure interactions, 24/7 customer support, and unique experiences at scale."
360dialog WhatsApp Business API
"WhatsApp Business solutions that drive real results"
Gupshup WhatsApp Business API
"The all-in-one platform for managing conversations at scale"
References
- ↑Description: developers.facebook.com
- ↑Self-serve signup: developers.facebook.com
- ↑Webhooks: developers.facebook.com
- ↑Sandbox: developers.facebook.com
- ↑SDK languages: github.com
- ↑MCP server: pulsemcp.com
- ↑SOC 2: developers.facebook.com · facebook.com
- ↑HIPAA: facebook.com
- ↑GDPR: developers.facebook.com · developers.facebook.com
- ↑ISO 27001: facebook.com
- ↑Published SLA: developers.facebook.com
- ↑Rate limits: developers.facebook.com · developers.facebook.com
Change history
- 2026-06-16 Summary Md: (none) → WhatsApp Cloud API is Meta's hosted REST API for sending and receiving WhatsApp…
- 2026-06-16 Scoring Methodology: (none) → Scores are computed deterministically from this profile's published, sourced fi…
- 2026-06-16 Score Setup Speed: (none) → 65
- 2026-06-16 Score Docs Quality: (none) → 25
- 2026-06-16 Score Procurement Friction: (none) → 75
- 2026-06-16 Score Trust Readiness: (none) → 55
- 2026-06-16 Best For: (none) → AI agents and automation - an agent-ready surface (MCP / llms.txt), Teams needi…
- 2026-06-16 Avoid If: (none) → You want to try it free before paying
- 2026-06-16 Score Agent Friendliness: (none) → 45
- 2026-06-16 Score Pricing Transparency: (none) → 60
- 2026-06-16 Llms Txt URL: (none) → https://developers.facebook.com/llms.txt
- 2026-06-16 Rendering: (none) → static
- 2026-06-16 Has Structured Data: (none) → No
- 2026-06-16 Robots Allows Agents: (none) → Yes
- 2026-06-16 Docs URL: (none) → https://developers.facebook.com/docs
- 2026-06-16 Llms Txt Present: (none) → Yes
- 2026-06-16 SDK Packages: set to Node.js
- 2026-06-16 MCP Server Available: set to No
- 2026-06-16 Pricing Model: set to usage_based
- 2026-06-16 Has Published Pricing: set to Yes
- 2026-06-16 Free Tier Available: set to No
- 2026-06-16 Free Tier Details: set to No $0 platform plan exists - Meta charges only per delivered template message. …
- 2026-06-16 Self Serve Signup: set to Yes
- 2026-06-16 Requires Sales Call: set to No
- 2026-06-16 Enterprise Plan Available: set to No
- 2026-06-16 SOC 2: set to type_2
- 2026-06-16 HIPAA: set to No
- 2026-06-16 GDPR: set to Yes
- 2026-06-16 ISO 27001: set to Yes
- 2026-06-16 SLA Published: set to No
- 2026-06-16 Data Retention Policy URL: set to https://www.facebook.com/privacy/policy/
- 2026-06-16 Documented Rate Limits: set to New business phone numbers default to 250 unique users/24 hours; scales through…
- 2026-06-16 Known Restrictions: set to Requires Meta Business Account (WABA) setup and phone number registration befor…
- 2026-06-16 Auth Methods: set to oauth2, api_key
- 2026-06-16 Auth Docs URL: set to https://developers.facebook.com/documentation/business-messaging/whatsapp/acces…
- 2026-06-16 API Style: set to rest
- 2026-06-16 Base URL: set to https://graph.facebook.com
- 2026-06-16 API Version: set to v21.0
- 2026-06-16 Versioning Scheme: set to url
- 2026-06-16 Stability: set to ga
- 2026-06-16 Deprecation Policy URL: set to https://developers.facebook.com/docs/graph-api/guides/versioning/
- 2026-06-16 Quickstart URL: set to https://developers.facebook.com/docs/whatsapp/cloud-api/get-started/
- 2026-06-16 Idempotency Supported: set to No
- 2026-06-16 Error Format: set to vendor-specific
- 2026-06-16 Webhook Signing: set to X-Hub-Signature-256
- 2026-06-16 Rate Limit Requests: set to 80
- 2026-06-16 Requires Verification: set to Yes
- 2026-06-16 Price Basis: set to per message
- 2026-06-16 Free Tier Limit: set to Service conversations (user-initiated) are free for all businesses (unlimited, …
- 2026-06-16 Launched At: set to 2021-11-01
Suggest an edit / leave a review
Leave a review or comment
curl -X POST https://apio.sh/api/feedback/meta-whatsapp-cloud \
-H 'Content-Type: application/json' \
-d '{"kind":"review","rating":5,"body":"Your experience with this API…"}'Suggest a correction to a field (cite a source)
curl -X POST https://apio.sh/api/suggest/meta-whatsapp-cloud/FIELD \
-H 'Content-Type: application/json' \
-d '{"value":"corrected value","citations":[{"url":"https://source.example/page","excerpt":"supporting quote"}],"note":"what changed and why"}'