WhatsApp API — Docs, OpenAPI & Kin Score

WhatsApp, owned by Meta Platforms, is a free, end-to-end encrypted messaging and calling app used by more than two billion people. For developers it offers the WhatsApp Business Platform: the Cloud API (hosted on Meta's Graph API at graph.facebook.com) for sending and receiving messages, media, interactive and template messages, plus the Business Management API, WhatsApp Flows, webhooks, and per-conversation pricing. The self-hosted On-Premises API was sunset on October 23, 2025.

WhatsApp publishes 74 API contracts indexed on the APIs.io network, including Flows API, On-Premises API, Analytics API, and 71 more. Tagged areas include Messaging, Analytics, WhatsApp, Business Messaging, and Meta.

The WhatsApp catalog on APIs.io includes 1 event-driven AsyncAPI specification, 1 JSON-LD context, and 4 Spectral governance rulesets.

WhatsApp’s developer surface includes changelog, authentication, getting-started guide, engineering blog, support, developer console, Stack Overflow tag, and 89 more developer resources.

🌐 Visit website 📡 Profile data on GitHub

68.0/100 exemplar ▲ 12.6 Agent 48/100 agent ready Front door AI 1/6 silent Heartbeat 89/100 alive open core · MIT Full breakdown ↓
scored 2026-11-06 · rubric v0.27.0 · Show this score on your site →

AccessPaid

3 published contracts 1 MCP Servers 10 Agent Skills

Messaging Analytics WhatsApp Business Messaging Meta

What this lets a business do 1

Business capabilities this provider's published APIs can perform, derived from its own contracts. Browse all capabilities →

Application Communications

AE-150

Messages

POST /{Version}/{Phone-Number-ID}/messages POST /{phone-number-id}/messages

Kin Score

Kin Score How this is scored →
scored 2026-11-06 · rubric v0.27.0

Composite quality — 68.0/100 · exemplar

Contract Quality 12.0 / 16

Developer Ergonomics 10.1 / 13

Access Clarity 9.6 / 13

Operational Transparency 5.8 / 8

Contract Governance 2.5 / 8

Discoverability 4.0 / 7

Regulatory Posture 6.0 / 15

Open Source Surface 4.0 / 10

Create-or-Update Ergonomics 0.0 / 10

Agent readiness — 48/100 · agent ready

Machine-Readable Contract 18 / 18

Agentic Access Contract 10 / 10

Documented Reversibility 0 / 6

MCP Server 12 / 12

Machine-Readable Auth 10 / 10

Idempotency 9 / 9

Stable Error Semantics 8 / 8

Request/Response Examples 7 / 7

Rate-Limit Signaling 7 / 7

Typed Event Surface 6 / 6

Agent Skills 5 / 5

Well-Known Catalog 4 / 4

Consent & Bot Identity 0 / 3

A2A Agent Card 0 / 8

Dry-Run / Simulate Mode 0 / 4

Delegated User Identity 0 / 6

Protected Resource Metadata 0 / 5

Registration Without a Human 0 / 6

Agentic Commerce Well-Known Document 0 / 5

Pagination 0 / 5

Distinct Operations 3 / 3

MCP Tool Quality 6 / 6

Regulatory Posture applies to this provider. Its tags matched the Horizontal (data, software, accessibility, platform) regime, so Regulatory Posture carries 15 points of the composite. If this regime is wrong for your business, say so on your provider repo — the applicability map is public and we will correct it.

Open Source Surface applies to this provider. This product is open source and we read its repository directly, so Open Source Surface carries 10 points of the composite. It is scored from what the repository actually publishes — a security policy, a contribution guide, a release history, a code of conduct — read live from the provider rather than inferred from our own catalog pointers. This facet adds; nothing was taken away to make room for it. An open-source project is not excused from the commercial facets, because exemption would strip it of the points it does earn. If we have the wrong repository, or this product is not open source, say so on your provider repo and we will drop the facet rather than have you publish against it.

Create-or-Update Ergonomics applies to this provider. This API accepts writes, so it carries 10 points of the composite. It is scored from the published contracts themselves: whether a caller can create-or-update in one call, whether the write accepts a key the caller already holds, and whether the response says which branch ran. Without that, every write needs a search-and-branch in front of it, and the first time that check is skipped a duplicate record is created. Scored against the observed mean rather than raw — a provider at the catalog average is unchanged by this facet, not penalised by it.

The six quality facets above are damped to 65 points between them, because both conditional facets apply and carry 35 points together. That is why each facet's contribution is shown against a damped maximum: raising a quality facet moves the composite by 65% of its nominal weight, not 100%. The full arithmetic is at apis.io/rating/.

Show this score on your site.

It updates itself when the score changes. Paste this where you link to your API docs:

<a href="https://apis.io/providers/whatsapp/"><img src="https://apis.io/badge/whatsapp/card.svg" alt="WhatsApp on APIs.io — Kin Score by API Evangelist"></a>

Other styles, a README pill and a shields.io endpoint are on the badge page.

Raise your score.

Agent readiness — checks not met, largest first (exact, from this profile):

A2A Agent Card +8 pts — a2a/-a2a.yml manifest, graded on conformance.grade against A2A 1.0.0
Registration Without a Human +6 pts — a `registration_endpoint` in the served RFC 8414 / OIDC discovery document
Delegated User Identity +6 pts — a served discovery document listing authorization_code in grant_types_supported (served), else an oauth2 authorizationCode flow or openIdConnect declared in an OpenAPI (documented)
Documented Reversibility +6 pts — a reversal operation in the contract, graded up when a window is documented too
Pagination +5 pts — share of collection GETs (an array, or one wrapped in data/items/results ...) that declare a page/limit/offset/cursor parameter, a Link header or a next/cursor field; na with no collection GETs
Protected Resource Metadata +5 pts — a served /.well-known/oauth-protected-resource carrying `resource` (documented), and naming its authorization_servers (verified)

3 more unmet checks in the Agent Readiness table above.

Kin Score — facets with the most composite points still available (weight × headroom):

Contract Governance scores 31.8 — up to +8.2 composite points
Contract Quality scores 74.0 — up to +6.5 composite points
Access Clarity scores 73.7 — up to +5.3 composite points

Each check links to what satisfies it. Publish the artifact, or tell us where it already lives, and the score moves on the next scoring run.

Improve this rating by publishing the missing artifacts — every area above can be raised, and the full rubric is at apis.io/rating/. Every facet and dimension name above is a link: it opens that measurement's own page — what it means, the exact checks that feed it, how the whole catalog distributes on it, and the providers at the top of it. This rating is computed from the provider profile at artifacts.apis.io/whatsapp/apis.yml: open an issue on github.com/api-evangelist/whatsapp to ask a question or point us at an artifact you publish. Submit an artifact on GitHub — free → Manage your own listing — the Influence plan, $499/mo →

Markets this provider is in provisional

The Kin Score Market layer reads a provider inside its market: its position, and how deep its integrations go. Depth is only comparable within a position. Provisional and unweighted: not part of the Kin Score or agent readiness.

Market	Position	Depth	Registered MCP server	Declares compatibility
Raycast Store Extensions (first-party publishers + community-wrapped products)	covered	36.9	-	-

Registered MCP server and declares compatibility are report only — not weighted. Undeclared means we found nothing we can read, so there is no number: we never infer integrations.

Standards implemented 3

Standards this provider implements or carries. De facto ones are profiled and measured by the API Commons; formal ones come from the standards directory and are linked by the provider's own tags. The evidence column says how each claim was established — not that it was made.

Model Context Protocol (MCP)

measured — observed by APIs.io (documented)

OpenAPI

measured — observed by APIs.io (published)

Postman Collections

measured — observed by APIs.io (published)

APIs 74

Individual APIs this provider publishes, each with its own machine-readable definition.

WhatsApp Flows API

API for creating structured, interactive forms and multi-step flows within WhatsApp conversations, enabling appointment booking, surveys, lead capture, and other guided experien...

WhatsApp On-Premises API

The self-hosted version of the WhatsApp Business API that allowed businesses to run the API on their own infrastructure. This API was deprecated on October 23, 2025, and all use...

WhatsApp Analytics API

Retrieve conversation and template analytics

WhatsApp Assets API

Upload and retrieve flow JSON assets

WhatsApp Assigned Users API

Manage user access to a WABA

WhatsApp Business Accounts API

Manage WhatsApp Business Account information

WhatsApp Business Profile API

Get and update WhatsApp Business profile information

WhatsApp Lifecycle API

Publish and deprecate flows

WhatsApp Media API

Upload, retrieve, and delete media files

WhatsApp Message Templates API

Create, update, and delete message templates

WhatsApp Messages API

Send messages of all types to WhatsApp users

WhatsApp Phone Numbers API

List and manage phone numbers on a WABA

WhatsApp Product Catalogs API

Connect and manage product catalogs

WhatsApp QR Codes API

Create and manage QR codes for customer conversations

WhatsApp Registration API

WhatsApp Subscribed Apps API

Manage webhook subscriptions for a WABA

WhatsApp Two-Step Verification API

Manage two-step verification PIN

WhatsApp Application Business Connections API

APIs for managing application connected client business relationships

WhatsApp Assigned WhatsApp Business Accounts API

APIs for managing assigned WhatsApp Business Accounts for users

WhatsApp Billing API

The Billing API from WhatsApp — 1 operation(s) for billing.

WhatsApp Block Users API

The Block Users API from WhatsApp — 1 operation(s) for block users.

WhatsApp Business Compliance API

APIs for retrieving WhatsApp Business Account compliance information

WhatsApp Business Encryption API

APIs for managing WhatsApp Business Account encryption configuration

WhatsApp Business Phone Numbers API

APIs for managing phone numbers in WhatsApp Business Accounts

WhatsApp Business Portfolio API

The Business Portfolio API from WhatsApp — 1 operation(s) for business portfolio.

WhatsApp Call Permissions API

Use the **`/{Phone-Number-ID}/call_permissions`** endpoint to check whether you have permission to call a specific WhatsApp user and understand what calling-related actions are ...

WhatsApp Calls API

Use the **`/{Phone-Number-ID}/calls`** endpoint to initiate, manage, and terminate WhatsApp calls. This API allows businesses to handle voice calling functionality through the W...

WhatsApp Client WhatsApp Business Accounts API

APIs for managing client WhatsApp Business Account relationships

WhatsApp Commerce Settings API

The Commerce Settings API from WhatsApp — 1 operation(s) for commerce settings.

WhatsApp Conversational Automation API

APIs for managing conversational automation settings and bot configurations

WhatsApp Create Flow API

The Create Flow API from WhatsApp — 2 operation(s) for create flow.

WhatsApp Encrypted Messages API

Payload encryption provides an additional layer of security on top of existing standard TLS/SSL that secures communication between Cloud API and businesses. When enabled, all me...

WhatsApp Get Endpoint Metrics API

The Get Endpoint Metrics API from WhatsApp — 1 operation(s) for get endpoint metrics.

WhatsApp Groups API

The Groups API from WhatsApp — 1 operation(s) for groups.

WhatsApp Individual QR Code API

APIs for retrieving and deleting individual WhatsApp Business message QR codes

WhatsApp Invite Link API

The Invite Link API from WhatsApp — 1 operation(s) for invite link.

WhatsApp Join Requests API

The Join Requests API from WhatsApp — 1 operation(s) for join requests.

WhatsApp Marketing Messages API

Send marketing template messages to WhatsApp users using pre-approved templates.

WhatsApp Message History API

APIs for retrieving WhatsApp Business Account message history and delivery status information

WhatsApp Message History Events API

APIs for retrieving WhatsApp Business Message History Events and delivery status occurrences

WhatsApp Meta Graph API Application Connected Client Businesses API

The Meta Graph API Application Connected Client Businesses API from WhatsApp — 1 operation(s) for meta graph api application connected client businesses.

WhatsApp Migration Intent API

APIs for retrieving WhatsApp Business Account migration intent details

WhatsApp MM Lite Onboarding API

APIs for managing Multi-Partner MM Lite onboarding requests and business agreements

WhatsApp Multi-Partner Solutions API

APIs for managing Multi-Partner Solutions that enable collaborative WhatsApp Business messaging between solution owners and partner applications.

WhatsApp OBO Mobility Intent API

APIs for managing On-Behalf-Of mobility intent operations for WhatsApp Business Accounts

WhatsApp Official Business Account API

APIs for managing Official Business Account status and verification

WhatsApp Owned WhatsApp Business Accounts API

APIs for retrieving WhatsApp Business Accounts owned by a business

WhatsApp Participants API

The Participants API from WhatsApp — 1 operation(s) for participants.

WhatsApp Phone Number Management API

APIs for managing WhatsApp Business phone number registration and deregistration

WhatsApp Phone Number Registration API

APIs for registering and managing WhatsApp Business phone numbers

WhatsApp Phone Number Verification API

APIs for WhatsApp Business phone number verification process

WhatsApp Pre-Verified Phone Number Partners API

APIs for managing partner businesses associated with pre-verified phone numbers

WhatsApp Pre-Verified Phone Number Sharing API

APIs for sharing pre-verified phone numbers between business entities

WhatsApp Pre-Verified Phone Numbers API

APIs for managing pre-verified phone numbers for WhatsApp Business messaging

WhatsApp QR Code Collection API

APIs for listing and creating WhatsApp Business message QR codes

WhatsApp Schedule Management API

APIs for managing WhatsApp Business Account schedules and scheduling configurations

WhatsApp Send Flow API

The Send Flow API from WhatsApp — 1 operation(s) for send flow.

WhatsApp Settings API

The Settings API from WhatsApp — 1 operation(s) for settings.

WhatsApp Setup Endpoint Encryption API

The Setup Endpoint Encryption API from WhatsApp — 1 operation(s) for setup endpoint encryption.

WhatsApp Solution Migration API

APIs for managing Multi-Partner Solution migration processes

WhatsApp Templates API

The Templates API from WhatsApp — 2 operation(s) for templates.

WhatsApp Update Flow API

The Update Flow API from WhatsApp — 4 operation(s) for update flow.

WhatsApp Webhook Subscriptions API

APIs for managing WhatsApp Business Account webhook subscriptions

WhatsApp WhatsApp Account Numbers API

APIs for managing WhatsApp Account Number details and configuration

WhatsApp WhatsApp Business Account Activities API

APIs for retrieving WhatsApp Business Account activity logs and audit trails

WhatsApp WhatsApp Business Account API

APIs for managing WhatsApp Business Account details and configuration

WhatsApp WhatsApp Business Account On-Behalf Requests API

APIs for managing WhatsApp Business Account on-behalf requests and business relationships

WhatsApp WhatsApp Business Account Users API

APIs for managing user assignments and permissions for WhatsApp Business Accounts

WhatsApp WhatsApp Business API

WhatsApp Business Platform APIs for messaging, account management, and partner integrations.

WhatsApp WhatsApp Business Bot API

APIs for managing WhatsApp Business Bot configuration and details

WhatsApp WhatsApp Business Profile API

APIs for managing WhatsApp Business Profile information and settings

WhatsApp WhatsApp Business Profiles API

APIs for managing WhatsApp Business Profile details and configuration

WhatsApp WhatsApp Business Solution Management API

Operations for managing WhatsApp Business Multi-Partner Solutions including lifecycle management, status transitions, and partnership workflows.

WhatsApp Whats App API

The Whats App API from WhatsApp — 1 operation(s) for whats app.

Scroll for all 74

Postman Collections 3

Ready-to-run Postman collections for exercising this provider's APIs.

WhatsApp Business Management API

POSTMAN

WhatsApp Cloud API

POSTMAN

WhatsApp Flows API

POSTMAN

Open Collections 18

Open, tool-agnostic API collections (OpenAPI-derived and Bruno).

WhatsApp Business Management Analytics API

OPEN COLLECTION

WhatsApp Business Management Analytics Assets API

OPEN COLLECTION

WhatsApp Business Management Analytics Assigned Users API

OPEN COLLECTION

WhatsApp Business Management Analytics Business Accounts API

OPEN COLLECTION

WhatsApp Business Management API

OPEN COLLECTION

WhatsApp Business Management Analytics Business Profile API

OPEN COLLECTION

WhatsApp Cloud API

OPEN COLLECTION

WhatsApp Business Management Analytics Flows API

OPEN COLLECTION

WhatsApp Business Management Analytics Lifecycle API

OPEN COLLECTION

WhatsApp Business Management Analytics Media API

OPEN COLLECTION

WhatsApp Business Management Analytics Message Templates API

OPEN COLLECTION

WhatsApp Business Management Analytics Messages API

OPEN COLLECTION

WhatsApp Business Management Analytics Phone Numbers API

OPEN COLLECTION

WhatsApp Business Management Analytics Product Catalogs API

OPEN COLLECTION

WhatsApp Business Management Analytics QR Codes API

OPEN COLLECTION

WhatsApp Business Management Analytics Registration API

OPEN COLLECTION

WhatsApp Business Management Analytics Subscribed Apps API

OPEN COLLECTION

WhatsApp Business Management Analytics Two-Step Verification API

OPEN COLLECTION

Scroll for all 18

Arazzo Workflows 14

Multi-step API workflows described with the Arazzo specification.

WhatsApp Create and Retrieve QR Code

Create a click-to-chat QR code and read back its deep link and image URLs.

ARAZZO

WhatsApp Create Template then Send

Create a new message template and send it once it is available.

ARAZZO

WhatsApp Build, Publish, and Send a Flow

Create a flow, upload its JSON, publish it, and send it as an interactive flow message.

ARAZZO

WhatsApp Verify and Register Phone Number

Request a verification code, verify it, then register the phone number.

ARAZZO

WhatsApp Send Message then React to It

Send a text message and then apply an emoji reaction to that same message.

ARAZZO

WhatsApp Check Number then Send Interactive Buttons

Confirm the sending number is verified, then send an interactive reply-button message.

ARAZZO

WhatsApp Confirm Profile then Send Location

Read the business profile to confirm the sender, then send a location pin.

ARAZZO

WhatsApp Find Approved Template and Send

Look up an approved message template by name and send it to a recipient.

ARAZZO

WhatsApp Send Text and Mark Inbound Read

Send a text reply and mark the customer's inbound message as read.

ARAZZO

WhatsApp Subscribe App to WABA Webhooks

Confirm the WABA is active, subscribe the app to webhooks, then list subscriptions.

ARAZZO

WhatsApp Read and Update Business Profile

Read the current business profile, then apply updates to it.

ARAZZO

WhatsApp Find and Update Message Template

Locate a template by name and edit its body, when it is in an editable state.

ARAZZO

WhatsApp Upload and Send Document

Upload a document file and send it to a recipient with a display filename.

ARAZZO

WhatsApp Upload Media and Send Image Message

Upload an image to WhatsApp servers and send it to a recipient by media ID.

ARAZZO

Scroll for all 14

MCP Servers 1

Model Context Protocol servers that expose these APIs to AI agents.

WhatsApp Business Tools

Remote MCP server at mcp.facebook.com over streamable HTTP requiring OAuth; 18 tools listed.

MCP SERVER

Agent Skills 10

Packaged agent skills for driving this provider's APIs from an AI assistant.

whatsapp-create-qr-code

AGENT SKILL

whatsapp-create-template-then-send

AGENT SKILL

whatsapp-publish-flow-and-send

AGENT SKILL

whatsapp-register-phone-number

AGENT SKILL

whatsapp-reply-and-mark-read

AGENT SKILL

whatsapp-send-template-message

AGENT SKILL

whatsapp-subscribe-webhooks

AGENT SKILL

whatsapp-update-business-profile

AGENT SKILL

whatsapp-upload-media-send-document

AGENT SKILL

whatsapp-upload-media-send-image

AGENT SKILL

Scroll for all 10

WhatsApp API pricing

Prices published by WhatsApp, read 2026-10-28 from developers.facebook.com/documentation/business-messaging/....

Plan	Price
Meta Business Agent messages	One global rate of $2.00 USD per 1 million (M) tokens. per 1M tokens
Marketing, utility, authentication, service messages	Rate: Varies by market, aligned to industry standards. per delivered message Includes: 1,000 free service messages per month per business phone number; free entry point window messages

Plan details, limits and sources →

Rate limits

Business Management endpoints (default): your app can make 200 requests per hour, per app, per Messaging account, by default
Business Management endpoints (active account): your app can make 5000 requests per hour, per app, per active Messaging account
Credit Line API: your app can make 5000 requests per hour

All 9 limits →

Billed by: 1m tokens · FinOps profile →

Pricing Plans 1

Published pricing tiers and plan structures.

Whatsapp Plans Pricing

2 plans

PLANS

Rate Limits 1

Documented rate limits and quota policies.

Whatsapp Rate Limits

9 limits

RATE LIMITS

Service Levels 1

Uptime the provider promises or reports, as SLA4OAI. Read from its own pages; APIs.io runs no monitors.

SLA

FinOps 1

Cost, billing, and metering signals for API financial operations.

Whatsapp Finops

FINOPS

Event Specifications 1

AsyncAPI definitions for this provider's event-driven and streaming APIs.

WhatsApp Webhooks

WhatsApp Business Platform webhooks deliver real-time notifications for incoming messages, message status updates, template status changes, account updates, phone number quality...

ASYNCAPI

Semantic Vocabularies 1

JSON-LD contexts and semantic vocabularies used across these APIs.

Whatsapp Context

33 classes · 109 properties

JSON-LD

Spectral Rules 4

Spectral governance rulesets for linting and validating these APIs.

WhatsApp — asyncapi rules

8 rules · 1 errors 7 warnings

SPECTRAL

WhatsApp — jsonschema rules

6 rules · 5 warnings 1 info

SPECTRAL

WhatsApp API Rules

71 rules · 46 errors 19 warnings 6 info

SPECTRAL

WhatsApp API Rules

22 rules · 13 errors 8 warnings 1 info

SPECTRAL

OpenAPI Overlays 17

Overlays applied on top of this provider's contracts. Each card says who wrote it: a document the provider publishes, or one API Evangelist derived or generated.

Whatsapp Analytics Api Overlay

1 action · update · whatsapp-analytics-api-openapi.yml

DERIVED

Whatsapp Assets Api Overlay

1 action · update · whatsapp-assets-api-openapi.yml

DERIVED

Whatsapp Assigned Users Api Overlay

1 action · update · whatsapp-assigned-users-api-openapi.yml

DERIVED

Whatsapp Business Accounts Api Overlay

1 action · update · whatsapp-business-accounts-api-openapi.yml

DERIVED

Whatsapp Business Messaging Api Overlay

5 actions · update · whatsapp-business-messaging-api-openapi.yml

DERIVED

Whatsapp Business Profile Api Overlay

1 action · update · whatsapp-business-profile-api-openapi.yml

DERIVED

Whatsapp Flows Api Overlay

1 action · update · whatsapp-flows-api-openapi.yml

DERIVED

Whatsapp Lifecycle Api Overlay

1 action · update · whatsapp-lifecycle-api-openapi.yml

DERIVED

Whatsapp Media Api Overlay

1 action · update · whatsapp-media-api-openapi.yml

DERIVED

Whatsapp Message Templates Api Overlay

5 actions · update · whatsapp-message-templates-api-openapi.yml

DERIVED

Whatsapp Messages Api Overlay

2 actions · update · whatsapp-messages-api-openapi.yml

DERIVED

Whatsapp Phone Numbers Api Overlay

3 actions · update · whatsapp-phone-numbers-api-openapi.yml

DERIVED

Whatsapp Product Catalogs Api Overlay

1 action · update · whatsapp-product-catalogs-api-openapi.yml

DERIVED

Whatsapp Qr Codes Api Overlay

1 action · update · whatsapp-qr-codes-api-openapi.yml

DERIVED

Whatsapp Registration Api Overlay

4 actions · update · whatsapp-registration-api-openapi.yml

DERIVED

Whatsapp Subscribed Apps Api Overlay

2 actions · update · whatsapp-subscribed-apps-api-openapi.yml

DERIVED

Whatsapp Two Step Verification Api Overlay

1 action · update · whatsapp-two-step-verification-api-openapi.yml

DERIVED

Scroll for all 17

JSON Schema 41

Standalone JSON Schema definitions for this provider's data models.

ConversationAnalytics

1 properties

JSON SCHEMA

CreateTemplateRequest

5 properties

JSON SCHEMA

CursorPaging

3 properties

JSON SCHEMA

MessageTemplate

8 properties

JSON SCHEMA

PhoneNumber

11 properties

JSON SCHEMA

SuccessResponse

1 properties

JSON SCHEMA

TemplateAnalytics

1 properties

JSON SCHEMA

TemplateButton

8 properties

JSON SCHEMA

TemplateComponentDefinition

7 properties

JSON SCHEMA

WhatsAppBusinessAccount

11 properties

JSON SCHEMA

CallPermissionCheckResponsePayload

3 properties

JSON SCHEMA

CallRequestPayload

5 properties

JSON SCHEMA

AudioObject

2 properties

JSON SCHEMA

ContactObject

7 properties

JSON SCHEMA

DocumentObject

4 properties

JSON SCHEMA

InteractiveMessage

5 properties

JSON SCHEMA

ListSection

2 properties

JSON SCHEMA

LocationMessage

4 properties

JSON SCHEMA

MediaObject

3 properties

JSON SCHEMA

ReactionMessage

2 properties

JSON SCHEMA

SendMessageRequest

19 properties

JSON SCHEMA

SendMessageResponse

3 properties

JSON SCHEMA

StickerObject

2 properties

JSON SCHEMA

TemplateComponent

4 properties

JSON SCHEMA

TemplateMessage

3 properties

JSON SCHEMA

TemplateParameter

10 properties

JSON SCHEMA

TextMessage

2 properties

JSON SCHEMA

WhatsApp Flow JSON

4 properties

JSON SCHEMA

CreateFlowRequest

4 properties

JSON SCHEMA

CursorPaging

2 properties

JSON SCHEMA

Flow

10 properties

JSON SCHEMA

FlowValidationError

8 properties

JSON SCHEMA

SuccessResponse

1 properties

JSON SCHEMA

UpdateFlowRequest

4 properties

JSON SCHEMA

WhatsApp Message

17 properties

JSON SCHEMA

WhatsApp Message Template

5 properties

JSON SCHEMA

PhoneNumberInfo

6 properties

JSON SCHEMA

WhatsApp Webhook Payload

2 properties

JSON SCHEMA

WhatsAppAccountNumber

13 properties

JSON SCHEMA

WhatsAppBusinessAccount

17 properties

JSON SCHEMA

WhatsAppBusinessProfileNode

11 properties

JSON SCHEMA

Scroll for all 41

JSON Structure 35

JSON Structure definitions describing this provider's data shapes.

Whatsapp Business Management Api Conversation Analytics Structure

1 properties

JSON STRUCTURE

Whatsapp Business Management Api Create Template Request Structure

5 properties

JSON STRUCTURE

Whatsapp Business Management Api Cursor Paging Structure

3 properties

JSON STRUCTURE

Whatsapp Business Management Api Message Template Structure

8 properties

JSON STRUCTURE

Whatsapp Business Management Api Phone Number Structure

11 properties

JSON STRUCTURE

Whatsapp Business Management Api Success Response Structure

1 properties

JSON STRUCTURE

Whatsapp Business Management Api Template Analytics Structure

1 properties

JSON STRUCTURE

Whatsapp Business Management Api Template Button Structure

8 properties

JSON STRUCTURE

Whatsapp Business Management Api Template Component Definition Structure

7 properties

JSON STRUCTURE

Whatsapp Business Management Api Whats App Business Account Structure

11 properties

JSON STRUCTURE

Whatsapp Cloud Api Audio Object Structure

2 properties

JSON STRUCTURE

Whatsapp Cloud Api Contact Object Structure

7 properties

JSON STRUCTURE

Whatsapp Cloud Api Document Object Structure

4 properties

JSON STRUCTURE

Whatsapp Cloud Api Interactive Message Structure

5 properties

JSON STRUCTURE

Whatsapp Cloud Api List Section Structure

2 properties

JSON STRUCTURE

Whatsapp Cloud Api Location Message Structure

4 properties

JSON STRUCTURE

Whatsapp Cloud Api Media Object Structure

3 properties

JSON STRUCTURE

Whatsapp Cloud Api Reaction Message Structure

2 properties

JSON STRUCTURE

Whatsapp Cloud Api Send Message Request Structure

19 properties

JSON STRUCTURE

Whatsapp Cloud Api Send Message Response Structure

3 properties

JSON STRUCTURE

Whatsapp Cloud Api Sticker Object Structure

2 properties

JSON STRUCTURE

Whatsapp Cloud Api Template Component Structure

4 properties

JSON STRUCTURE

Whatsapp Cloud Api Template Message Structure

3 properties

JSON STRUCTURE

Whatsapp Cloud Api Template Parameter Structure

10 properties

JSON STRUCTURE

Whatsapp Cloud Api Text Message Structure

2 properties

JSON STRUCTURE

Whatsapp Flow Json Structure

4 properties

JSON STRUCTURE

Whatsapp Flows Api Create Flow Request Structure

4 properties

JSON STRUCTURE

Whatsapp Flows Api Cursor Paging Structure

2 properties

JSON STRUCTURE

Whatsapp Flows Api Flow Structure

10 properties

JSON STRUCTURE

Whatsapp Flows Api Flow Validation Error Structure

8 properties

JSON STRUCTURE

Whatsapp Flows Api Success Response Structure

1 properties

JSON STRUCTURE

Whatsapp Flows Api Update Flow Request Structure

4 properties

JSON STRUCTURE

Whatsapp Message Structure

17 properties

JSON STRUCTURE

Whatsapp Message Template Structure

5 properties

JSON STRUCTURE

Whatsapp Webhook Payload Structure

2 properties

JSON STRUCTURE

Scroll for all 35

Examples 35

Example request and response payloads for these APIs.

Whatsapp Business Management Api Conversation Analytics Example

1 fields

EXAMPLE

Whatsapp Business Management Api Create Template Request Example

5 fields

EXAMPLE

Whatsapp Business Management Api Cursor Paging Example

3 fields

EXAMPLE

Whatsapp Business Management Api Message Template Example

8 fields

EXAMPLE

Whatsapp Business Management Api Phone Number Example

10 fields

EXAMPLE

Whatsapp Business Management Api Success Response Example

1 fields

EXAMPLE

Whatsapp Business Management Api Template Analytics Example

1 fields

EXAMPLE

Whatsapp Business Management Api Template Button Example

8 fields

EXAMPLE

Whatsapp Business Management Api Template Component Definition Example

7 fields

EXAMPLE

Whatsapp Business Management Api Whats App Business Account Example

10 fields

EXAMPLE

Whatsapp Cloud Api Audio Object Example

2 fields

EXAMPLE

Whatsapp Cloud Api Contact Object Example

7 fields

EXAMPLE

Whatsapp Cloud Api Document Object Example

4 fields

EXAMPLE

Whatsapp Cloud Api Interactive Message Example

5 fields

EXAMPLE

Whatsapp Cloud Api List Section Example

2 fields

EXAMPLE

Whatsapp Cloud Api Location Message Example

4 fields

EXAMPLE

Whatsapp Cloud Api Media Object Example

3 fields

EXAMPLE

Whatsapp Cloud Api Reaction Message Example

2 fields

EXAMPLE

Whatsapp Cloud Api Send Message Request Example

10 fields

EXAMPLE

Whatsapp Cloud Api Send Message Response Example

3 fields

EXAMPLE

Whatsapp Cloud Api Sticker Object Example

2 fields

EXAMPLE

Whatsapp Cloud Api Template Component Example

4 fields

EXAMPLE

Whatsapp Cloud Api Template Message Example

3 fields

EXAMPLE

Whatsapp Cloud Api Template Parameter Example

10 fields

EXAMPLE

Whatsapp Cloud Api Text Message Example

2 fields

EXAMPLE

Whatsapp Flow Json Example

4 fields

EXAMPLE

Whatsapp Flows Api Create Flow Request Example

4 fields

EXAMPLE

Whatsapp Flows Api Cursor Paging Example

2 fields

EXAMPLE

Whatsapp Flows Api Flow Example

10 fields

EXAMPLE

Whatsapp Flows Api Flow Validation Error Example

8 fields

EXAMPLE

Whatsapp Flows Api Success Response Example

1 fields

EXAMPLE

Whatsapp Flows Api Update Flow Request Example

4 fields

EXAMPLE

Whatsapp Message Example

10 fields

EXAMPLE

Whatsapp Message Template Example

5 fields

EXAMPLE

Whatsapp Webhook Payload Example

2 fields

EXAMPLE

Scroll for all 35

Security Posture 3

Authentication, domain security, vulnerability disclosure, and trust-center signals.

Whatsapp Authentication

http · 1 scheme

SECURITY

Whatsapp Domain Security

TLSv1.3 · HSTS · DMARC

SECURITY

Whatsapp Vulnerability Disclosure

security.txt · contact published

SECURITY

Scopes 1

OAuth scopes governing access to this provider's APIs.

Whatsapp Scopes

5 scopes

SCOPES

Agentic Access 1

Recommended x-agentic-access execution contracts for AI agents.

Whatsapp Agentic Access

43 operations · 27 acting

AGENTIC

Resources

Get Started 5

Portal, sign-up, and the first successful call

DeveloperPortal

GettingStarted

Console

Sandbox

SignUp

Documentation 4

Reference material describing how the API behaves

ContributionGuide

JSONSchema

Documentation

APIReference

Agent Surfaces 5

MCP servers, agent skills, and machine-readable catalogs

AgentSkill

LLMsTxt

MCPServer

WellKnown

AgenticAccess

Design & Contract 31

Pagination, idempotency, versioning, errors, and events

Spectral

Spectral

Spectral

Spectral

Vocabulary

Webhooks

DataModel

Components

Idempotency

Conventions

Lifecycle

ErrorCatalog

ErrorCatalog

Conformance

Arazzo

Arazzo

Arazzo

Arazzo

Arazzo

Arazzo

Arazzo

Arazzo

Arazzo

Arazzo

Arazzo

Arazzo

Arazzo

Arazzo

JSONLD

Versioning

ErrorCodes

Scroll for all 31

Build 10

SDKs, sample code, and the tooling you integrate with

ToolCrosswalk

IntegrationEdges

SDKs

Packages

CodeOfConduct

PostmanWorkspace

GitHubOrganization

GitHubOrganization

PostmanCollection

PostmanCollection

Node.js SDK

Node.js SDK

ApiExamples

ApiExamples

Scroll for all 10

Access & Security 9

Authentication, authorization, and security posture

OAuthScopes

OAuthScopes

SecurityTxt

SecurityTxt

VulnerabilityDisclosure

VulnerabilityDisclosure

DomainSecurity

Authentication

Authentication

Security

SecurityAdvisories

SecurityAdvisories

TrustAndSafety

TrustAndSafety

Scroll for all 9

Operate 16

Status, limits, changes, and where to get help

RateLimits

ChangeLog

Deprecation

IssueTracker

ChangeLog

StatusPage

Support

Community

StackOverflow

FAQ

RateLimits

HelpCenter

Forum

RateLimits

StatusPage

Support

Scroll for all 16

Commercial 8

Pricing, plans, and the legal terms of use

Plans

FinOps

License

TermsOfService

PrivacyPolicy

Pricing

Meta Terms

Legal

Scroll for all 8

Company 4

The organization behind the API

Website

Blog

Blog

Website

Other 4

Properties that don't map to a standard resource type

Overlay

Overlay

Hosts

Hosts

CapabilityMap

CapabilityMap

Business Messaging Policy

Business Messaging Policy

Source (apis.yml)

aid: whatsapp
name: WhatsApp
description: 'WhatsApp, owned by Meta Platforms, is a free, end-to-end encrypted messaging and calling app used by more than
  two billion people. For developers it offers the WhatsApp Business Platform: the Cloud API (hosted on Meta''s Graph API
  at graph.facebook.com) for sending and receiving messages, media, interactive and template messages, plus the Business Management
  API, WhatsApp Flows, webhooks, and per-conversation pricing. The self-hosted On-Premises API was sunset on October 23, 2025.'
deliveryModel:
  model: open-core
  license: MIT
  open_source: true
  commercial: true
  callable_host: true
  label: Open core · an OSS project plus a commercial hosted product
  confidence: high
  source:
  - license
  - openapi
  - pricing
  generated: '2026-08-28'
  method: derived
accessModel:
  pricing: paid
  onboarding: unknown
  trial: false
  try_now: false
  public: false
  label: Paid
  confidence: high
  probe_state: covered
  source:
  - plans
  - authentication
  - scopes
  - rate-limits
  - security
  - sandbox
  generated: '2026-11-06'
  method: derived
image: https://kinlane-images.s3.amazonaws.com/shared/apis-json/icons/whatsapp.png
url: https://raw.githubusercontent.com/api-evangelist/whatsapp/refs/heads/main/apis.yml
created: '2024-01-15'
modified: '2026-11-05'
specificationVersion: '0.23'
maintainers:
- FN: Kin Lane
  email: kin@apievangelist.com
tags:
- Messaging
- Analytics
- WhatsApp
- Business Messaging
- Meta
common:
- type: RateLimits
  url: rate-limits/whatsapp-rate-limits.yml
- type: Spectral
  url: rules/whatsapp-spectral-rules.yml
- type: Spectral
  url: rules/whatsapp-rules.yml
- type: Spectral
  url: rules/whatsapp-jsonschema-spectral-rules.yml
- type: Spectral
  url: rules/whatsapp-asyncapi-spectral-rules.yml
- type: Vocabulary
  url: vocabulary/whatsapp-vocabulary.yml
- type: AgentSkill
  url: skills/_index.yml
- type: Webhooks
  url: asyncapi/whatsapp-webhooks-asyncapi.yml
- type: DataModel
  url: data-model/whatsapp-data-model.yml
- type: Components
  url: components/whatsapp-components.yml
- type: ChangeLog
  url: changelog/whatsapp-changelog.yml
- type: Idempotency
  url: conventions/whatsapp-conventions.yml
- type: Conventions
  url: conventions/whatsapp-conventions.yml
- type: OAuthScopes
  url: scopes/whatsapp-scopes.yml
- type: Deprecation
  url: lifecycle/whatsapp-lifecycle.yml
- type: Lifecycle
  url: lifecycle/whatsapp-lifecycle.yml
- type: ErrorCatalog
  url: errors/whatsapp-error-codes.yml
- type: ErrorCatalog
  url: errors/whatsapp-problem-types.yml
- type: Conformance
  url: conformance/whatsapp-conformance.yml
- type: Overlay
  url: overlays/whatsapp-analytics-api-overlay.yaml
- type: LLMsTxt
  url: llms/whatsapp-reference-llms.txt
- type: ToolCrosswalk
  url: mcp/whatsapp-tool-crosswalk.yml
- type: MCPServer
  url: mcp/whatsapp-mcp.yml
- type: SecurityTxt
  url: well-known/whatsapp-security.txt
- type: WellKnown
  url: well-known/whatsapp-well-known.yml
- type: Hosts
  url: hosts/whatsapp-hosts.yml
- type: IntegrationEdges
  url: integrations/whatsapp-integration-edges.yml
- type: SDKs
  url: packages/whatsapp-packages.yml
- type: Packages
  url: packages/whatsapp-packages.yml
- type: VulnerabilityDisclosure
  url: security/whatsapp-vulnerability-disclosure.yml
- type: DomainSecurity
  url: security/whatsapp-domain-security.yml
- type: CapabilityMap
  url: capabilities/whatsapp-capability-edges.yml
  name: WhatsApp Business Capability Map
- type: Plans
  url: plans/whatsapp-plans-pricing.yml
- type: FinOps
  url: finops/whatsapp-finops.yml
- type: Website
  url: https://www.whatsapp.com/
- type: IssueTracker
  url: https://github.com/WhatsApp/WhatsApp-Flows-Tools/issues
- type: CodeOfConduct
  url: https://github.com/WhatsApp/WhatsApp-Flows-Tools/blob/main/CODE_OF_CONDUCT.md
- type: ContributionGuide
  url: https://github.com/WhatsApp/WhatsApp-Flows-Tools/blob/main/CONTRIBUTING.md
- type: License
  name: MIT
  url: https://github.com/WhatsApp/WhatsApp-Flows-Tools/blob/main/LICENSE
- type: AgenticAccess
  url: agentic-access/whatsapp-agentic-access.yml
- type: Authentication
  url: authentication/whatsapp-authentication.yml
- type: PostmanWorkspace
  url: https://www.postman.com/kinlaneapi/whatsapp/overview
- type: Arazzo
  url: arazzo/whatsapp-create-qr-code-workflow.yml
  name: WhatsApp Create and Retrieve QR Code
- type: Arazzo
  url: arazzo/whatsapp-create-template-then-send-workflow.yml
  name: WhatsApp Create Template then Send
- type: Arazzo
  url: arazzo/whatsapp-publish-flow-and-send-workflow.yml
  name: WhatsApp Build, Publish, and Send a Flow
- type: Arazzo
  url: arazzo/whatsapp-register-phone-number-workflow.yml
  name: WhatsApp Verify and Register Phone Number
- type: Arazzo
  url: arazzo/whatsapp-send-and-react-workflow.yml
  name: WhatsApp Send Message then React to It
- type: Arazzo
  url: arazzo/whatsapp-send-interactive-buttons-workflow.yml
  name: WhatsApp Check Number then Send Interactive Buttons
- type: Arazzo
  url: arazzo/whatsapp-send-location-message-workflow.yml
  name: WhatsApp Confirm Profile then Send Location
- type: Arazzo
  url: arazzo/whatsapp-send-template-message-workflow.yml
  name: WhatsApp Find Approved Template and Send
- type: Arazzo
  url: arazzo/whatsapp-send-text-and-mark-read-workflow.yml
  name: WhatsApp Send Text and Mark Inbound Read
- type: Arazzo
  url: arazzo/whatsapp-subscribe-webhooks-workflow.yml
  name: WhatsApp Subscribe App to WABA Webhooks
- type: Arazzo
  url: arazzo/whatsapp-update-business-profile-workflow.yml
  name: WhatsApp Read and Update Business Profile
- type: Arazzo
  url: arazzo/whatsapp-update-template-workflow.yml
  name: WhatsApp Find and Update Message Template
- type: Arazzo
  url: arazzo/whatsapp-upload-media-send-document-workflow.yml
  name: WhatsApp Upload and Send Document
- type: Arazzo
  url: arazzo/whatsapp-upload-media-send-image-workflow.yml
  name: WhatsApp Upload Media and Send Image Message
- type: TermsOfService
  url: https://www.whatsapp.com/legal/business-terms
- type: PrivacyPolicy
  url: https://www.whatsapp.com/legal/privacy-policy-eea
- type: DeveloperPortal
  url: https://developers.facebook.com/
- type: GettingStarted
  url: https://developers.facebook.com/documentation/business-messaging/whatsapp/get-started
- type: Authentication
  url: https://developers.facebook.com/documentation/business-messaging/whatsapp/get-started
- type: UseCases
  url: https://whatsappbusiness.com/products/business-platform/
- type: ChangeLog
  url: https://developers.facebook.com/documentation/business-messaging/whatsapp/changelog
- type: StatusPage
  url: https://metastatus.com/
- type: Blog
  url: https://whatsappbusiness.com/blog/
- type: Support
  url: https://developers.facebook.com/support/
- type: Console
  url: https://developers.facebook.com/apps/
- type: GitHubOrganization
  url: https://github.com/WhatsApp
- type: Community
  url: https://whatsappbusiness.com/developers/developer-hub/
- type: StackOverflow
  url: https://stackoverflow.com/questions/tagged/whatsapp-cloud-api
- type: Security
  url: https://www.whatsapp.com/security/WhatsApp-Security-Whitepaper.pdf
- type: PostmanCollection
  url: https://www.postman.com/meta/whatsapp-business-platform/overview
- type: Pricing
  url: https://whatsappbusiness.com/products/platform-pricing/
- type: JSONLD
  url: json-ld/whatsapp-context.jsonld
- type: JSONSchema
  url: json-schema/whatsapp-webhook-payload-schema.json
- type: Node.js SDK
  url: https://github.com/WhatsApp/WhatsApp-Nodejs-SDK
- type: ApiExamples
  url: https://github.com/fbsamples/whatsapp-api-examples
- type: Business Messaging Policy
  url: https://whatsappbusiness.com/policy/
- type: Meta Terms
  url: https://www.facebook.com/legal/Meta-Terms-for-WhatsApp-Business-Platform
- type: FAQ
  url: https://whatsappbusiness.com/resources/faq/
- type: Sandbox
  url: https://whatsappbusiness.com/developers/developer-hub/
- type: Versioning
  url: https://developers.facebook.com/docs/graph-api/guides/versioning
- type: RateLimits
  url: https://developers.facebook.com/documentation/business-messaging/whatsapp/about-the-platform#throughput
- type: ErrorCodes
  url: https://developers.facebook.com/documentation/business-messaging/whatsapp/support/error-codes
- type: Documentation
  url: https://developers.facebook.com/documentation/business-messaging/whatsapp/overview
- type: APIReference
  url: https://developers.facebook.com/documentation/business-messaging/whatsapp/reference/whatsapp-business-phone-number/message-api
- type: SignUp
  url: https://developers.facebook.com/products/whatsapp/onboard/direct
- type: HelpCenter
  url: https://faq.whatsapp.com/
- type: Forum
  url: https://developers.facebook.com/community
- type: RateLimits
  url: https://developers.facebook.com/documentation/business-messaging/whatsapp/messaging-limits
- type: StatusPage
  url: https://developers.facebook.com/documentation/business-messaging/whatsapp/support/api-status-page
- type: SecurityAdvisories
  url: https://www.whatsapp.com/security/advisories
- type: TrustAndSafety
  url: https://whatsappbusiness.com/trust-and-safety/
- type: Blog
  url: https://blog.whatsapp.com/
- type: Legal
  url: https://www.whatsapp.com/legal/
- type: Website
  url: https://whatsappbusiness.com/
- type: Support
  url: https://developers.facebook.com/documentation/business-messaging/whatsapp/support
apis:
- name: WhatsApp Flows API
  description: API for creating structured, interactive forms and multi-step flows within WhatsApp conversations, enabling
    appointment booking, surveys, lead capture, and other guided experiences using a JSON-based screen definition format.
  image: https://static.whatsapp.net/rsrc.php/v4/yO/r/rukeqTVNJDY.png
  humanURL: https://developers.facebook.com/documentation/business-messaging/whatsapp/flows
  baseURL: https://graph.facebook.com/v21.0
  tags:
  - Flow
  - Forms
  - Interactive
  - Messaging
  tags_raw:
  - Flows
  - Forms
  - Interactive
  - Messaging
  properties:
  - type: Documentation
    url: https://developers.facebook.com/documentation/business-messaging/whatsapp/flows
  - type: OpenAPI
    url: openapi/whatsapp-flows-api-openapi.yml
  - type: Reference
    url: https://developers.facebook.com/documentation/business-messaging/whatsapp/flows/guides/components
  - type: JSONSchema
    url: json-schema/whatsapp-flow-json-schema.json
  - type: ChangeLog
    url: https://developers.facebook.com/documentation/business-messaging/whatsapp/flows/changelogs
  - type: ErrorCodes
    url: https://developers.facebook.com/documentation/business-messaging/whatsapp/flows/reference/error-codes
  - type: PostmanCollection
    url: https://www.postman.com/meta/whatsapp-business-platform/collection/y5swede/whatsapp-flows-api
  - type: GitHubRepository
    url: https://github.com/WhatsApp/WhatsApp-Flows-Tools
  - type: GettingStarted
    url: https://developers.facebook.com/documentation/business-messaging/whatsapp/flows/gettingstarted
  - type: Authentication
    url: https://developers.facebook.com/documentation/business-messaging/whatsapp/get-started
  aid: whatsapp:flows-api
- name: WhatsApp On-Premises API
  description: The self-hosted version of the WhatsApp Business API that allowed businesses to run the API on their own infrastructure.
    This API was deprecated on October 23, 2025, and all users must migrate to the Cloud API.
  image: https://static.whatsapp.net/rsrc.php/v4/yO/r/rukeqTVNJDY.png
  humanURL: https://developers.facebook.com/docs/whatsapp/on-premises/sunset
  baseURL: https://localhost:443
  tags:
  - Deprecated
  - Messaging
  - On-Premises
  - Self-Hosted
  properties:
  - type: Documentation
    url: https://developers.facebook.com/docs/whatsapp/on-premises/sunset
  - type: GettingStarted
    url: https://developers.facebook.com/docs/whatsapp/on-premises/sunset
  - type: Deprecation Notice
    url: https://developers.facebook.com/docs/whatsapp/on-premises/sunset
  - type: PostmanCollection
    url: https://www.postman.com/meta/whatsapp-business-platform/collection/vdi189b/whatsapp-on-premises-api-deprecated
  - type: Migration Guide
    url: https://developers.facebook.com/docs/whatsapp/on-premises/sunset
  aid: whatsapp:on-premises-api
- aid: whatsapp:whatsapp-analytics-api
  name: WhatsApp Analytics API
  description: Retrieve conversation and template analytics
  humanURL: https://developers.facebook.com/documentation/business-messaging/whatsapp/overview
  baseURL: https://graph.facebook.com/v21.0
  tags:
  - Analytics
  properties:
  - type: OpenAPI
    url: openapi/whatsapp-analytics-api-openapi.yml
  - type: Documentation
    url: https://developers.facebook.com/documentation/business-messaging/whatsapp/about-the-platform
  - type: Authentication
    url: https://developers.facebook.com/documentation/business-messaging/whatsapp/get-started
  - type: Documentation
    url: https://developers.facebook.com/documentation/business-messaging/whatsapp/webhooks/overview
  - type: AsyncAPI
    url: asyncapi/whatsapp-webhooks-asyncapi.yml
  - type: JSONSchema
    url: json-schema/whatsapp-message-schema.json
  - type: Reference
    url: https://developers.facebook.com/documentation/business-messaging/whatsapp/reference/whatsapp-business-phone-number/message-api
  - type: GettingStarted
    url: https://developers.facebook.com/documentation/business-messaging/whatsapp/get-started
  - type: Pricing
    url: https://developers.facebook.com/documentation/business-messaging/whatsapp/pricing
  - type: RateLimits
    url: https://developers.facebook.com/documentation/business-messaging/whatsapp/about-the-platform#throughput
  - type: StatusPage
    url: https://metastatus.com/
  - type: ChangeLog
    url: https://developers.facebook.com/documentation/business-messaging/whatsapp/changelog
  - type: ErrorCodes
    url: https://developers.facebook.com/documentation/business-messaging/whatsapp/support/error-codes
  - type: PostmanCollection
    url: https://www.postman.com/meta/whatsapp-business-platform/collection/wlk6lh4/whatsapp-cloud-api
  - type: Node.js SDK
    url: https://github.com/WhatsApp/WhatsApp-Nodejs-SDK
  - type: Sandbox
    url: https://whatsappbusiness.com/developers/developer-hub/
  - type: Media Reference
    url: https://developers.facebook.com/documentation/business-messaging/whatsapp/business-phone-numbers/media
  - type: Phone Numbers Reference
    url: https://developers.facebook.com/documentation/business-messaging/whatsapp/business-phone-numbers/phone-numbers
  - type: Business Profiles Reference
    url: https://developers.facebook.com/documentation/business-messaging/whatsapp/business-phone-numbers/business-profiles
  - type: Two-Step Verification
    url: https://developers.facebook.com/documentation/business-messaging/whatsapp/business-phone-numbers/two-step-verification
  - type: Versioning
    url: https://developers.facebook.com/docs/graph-api/guides/versioning
  - type: JSONSchema
    url: json-schema/whatsapp-message-template-schema.json
  - type: PostmanCollection
    url: https://www.postman.com/meta/whatsapp-business-platform/collection/3kru5r6/whatsapp-business-management-api
  - type: Reference
    url: https://developers.facebook.com/documentation/business-messaging/whatsapp/templates/overview
- aid: whatsapp:whatsapp-assets-api
  name: WhatsApp Assets API
  description: Upload and retrieve flow JSON assets
  humanURL: https://developers.facebook.com/documentation/business-messaging/whatsapp/overview
  baseURL: https://graph.facebook.com/v21.0
  tags:
  - Assets
  properties:
  - type: OpenAPI
    url: openapi/whatsapp-assets-api-openapi.yml
  - type: Documentation
    url: https://developers.facebook.com/documentation/business-messaging/whatsapp/about-the-platform
  - type: Authentication
    url: https://developers.facebook.com/documentation/business-messaging/whatsapp/get-started
  - type: Documentation
    url: https://developers.facebook.com/documentation/business-messaging/whatsapp/webhooks/overview
  - type: AsyncAPI
    url: asyncapi/whatsapp-webhooks-asyncapi.yml
  - type: JSONSchema
    url: json-schema/whatsapp-message-schema.json
  - type: Reference
    url: https://developers.facebook.com/documentation/business-messaging/whatsapp/reference/whatsapp-business-phone-number/message-api
  - type: GettingStarted
    url: https://developers.facebook.com/documentation/business-messaging/whatsapp/get-started
  - type: Pricing
    url: https://developers.facebook.com/documentation/business-messaging/whatsapp/pricing
  - type: RateLimits
    url: https://developers.facebook.com/documentation/business-messaging/whatsapp/about-the-platform#throughput
  - type: StatusPage
    url: https://metastatus.com/
  - type: ChangeLog
    url: https://developers.facebook.com/documentation/business-messaging/whatsapp/changelog
  - type: ErrorCodes
    url: https://developers.facebook.com/documentation/business-messaging/whatsapp/support/error-codes
  - type: PostmanCollection
    url: https://www.postman.com/meta/whatsapp-business-platform/collection/wlk6lh4/whatsapp-cloud-api
  - type: Node.js SDK
    url: https://github.com/WhatsApp/WhatsApp-Nodejs-SDK
  - type: Sandbox
    url: https://whatsappbusiness.com/developers/developer-hub/
  - type: Media Reference
    url: https://developers.facebook.com/documentation/business-messaging/whatsapp/business-phone-numbers/media
  - type: Phone Numbers Reference
    url: https://developers.facebook.com/documentation/business-messaging/whatsapp/business-phone-numbers/phone-numbers
  - type: Business Profiles Reference
    url: https://developers.facebook.com/documentation/business-messaging/whatsapp/business-phone-numbers/business-profiles
  - type: Two-Step Verification
    url: https://developers.facebook.com/documentation/business-messaging/whatsapp/business-phone-numbers/two-step-verification
  - type: Versioning
    url: https://developers.facebook.com/docs/graph-api/guides/versioning
  - type: JSONSchema
    url: json-schema/whatsapp-message-template-schema.json
  - type: PostmanCollection
    url: https://www.postman.com/meta/whatsapp-business-platform/collection/3kru5r6/whatsapp-business-management-api
  - type: Reference
    url: https://developers.facebook.com/documentation/business-messaging/whatsapp/templates/overview
- aid: whatsapp:whatsapp-assigned-users-api
  name: WhatsApp Assigned Users API
  description: Manage user access to a WABA
  humanURL: https://developers.facebook.com/documentation/business-messaging/whatsapp/overview
  baseURL: https://graph.facebook.com/v21.0
  tags:
  - Assigned Users
  properties:
  - type: OpenAPI
    url: openapi/whatsapp-assigned-users-api-openapi.yml
  - type: Documentation
    url: https://developers.facebook.com/documentation/business-messaging/whatsapp/about-the-platform
  - type: Authentication
    url: https://developers.facebook.com/documentation/business-messaging/whatsapp/get-started
  - type: Documentation
    url: https://developers.facebook.com/documentation/business-messaging/whatsapp/webhooks/overview
  - type: AsyncAPI
    url: asyncapi/whatsapp-webhooks-asyncapi.yml
  - type: JSONSchema
    url: json-schema/whatsapp-message-schema.json
  - type: Reference
    url: https://developers.facebook.com/documentation/business-messaging/whatsapp/reference/whatsapp-business-phone-number/message-api
  - type: GettingStarted
    url: https://developers.facebook.com/documentation/business-messaging/whatsapp/get-started
  - type: Pricing
    url: https://developers.facebook.com/documentation/business-messaging/whatsapp/pricing
  - type: RateLimits
    url: https://developers.facebook.com/documentation/business-messaging/whatsapp/about-the-platform#throughput
  - type: StatusPage
    url: https://metastatus.com/
  - type: ChangeLog
    url: https://developers.facebook.com/documentation/business-messaging/whatsapp/changelog
  - type: ErrorCodes
    url: https://developers.facebook.com/documentation/business-messaging/whatsapp/support/error-codes
  - type: PostmanCollection
    url: https://www.postman.com/meta/whatsapp-business-platform/collection/wlk6lh4/whatsapp-cloud-api
  - type: Node.js SDK
    url: https://github.com/WhatsApp/WhatsApp-Nodejs-SDK
  - type: Sandbox
    url: https://whatsappbusiness.com/developers/developer-hub/
  - type: Media Reference
    url: https://developers.facebook.com/documentation/business-messaging/whatsapp/business-phone-numbers/media
  - type: Phone Numbers Reference
    url: https://developers.facebook.com/documentation/business-messaging/whatsapp/business-phone-numbers/phone-numbers
  - type: Business Profiles Reference
    url: https://developers.facebook.com/documentation/business-messaging/whatsapp/business-phone-numbers/business-profiles
  - type: Two-Step Verification
    url: https://developers.facebook.com/documentation/business-messaging/whatsapp/business-phone-numbers/two-step-verification
  - type: Versioning
    url: https://developers.facebook.com/docs/graph-api/guides/versioning
  - type: JSONSchema
    url: json-schema/whatsapp-message-template-schema.json
  - type: PostmanCollection
    url: https://www.postman.com/meta/whatsapp-business-platform/collection/3kru5r6/whatsapp-business-management-api
  - type: Reference
    url: https://developers.facebook.com/documentation/business-messaging/whatsapp/templates/overview
- aid: whatsapp:whatsapp-business-accounts-api
  name: WhatsApp Business Accounts API
  description: Manage WhatsApp Business Account information
  humanURL: https://developers.facebook.com/documentation/business-messaging/whatsapp/overview
  baseURL: https://graph.facebook.com/v21.0
  tags:
  - Business Accounts
  properties:
  - type: OpenAPI
    url: openapi/whatsapp-business-accounts-api-openapi.yml
  - type: Documentation
    url: https://developers.facebook.com/documentation/business-messaging/whatsapp/about-the-platform
  - type: Authentication
    url: https://developers.facebook.com/documentation/business-messaging/whatsapp/get-started
  - type: Documentation
    url: https://developers.facebook.com/documentation/business-messaging/whatsapp/webhooks/overview
  - type: AsyncAPI
    url: asyncapi/whatsapp-webhooks-asyncapi.yml
  - type: JSONSchema
    url: json-schema/whatsapp-message-schema.json
  - type: Reference
    url: https://developers.facebook.com/documentation/business-messaging/whatsapp/reference/whatsapp-business-phone-number/message-api
  - type: GettingStarted
    url: https://developers.facebook.com/documentation/business-messaging/whatsapp/get-started
  - type: Pricing
    url: https://developers.facebook.com/documentation/business-messaging/whatsapp/pricing
  - type: RateLimits
    url: https://developers.facebook.com/documentation/business-messaging/whatsapp/about-the-platform#throughput
  - type: StatusPage
    url: https://metastatus.com/
  - type: ChangeLog
    url: https://developers.facebook.com/documentation/business-messaging/whatsapp/changelog
  - type: ErrorCodes
    url: https://developers.facebook.com/documentation/business-messaging/whatsapp/support/error-codes
  - type: PostmanCollection
    url: https://www.postman.com/meta/whatsapp-business-platform/collection/wlk6lh4/whatsapp-cloud-api
  - type: Node.js SDK
    url: https://github.com/WhatsApp/WhatsApp-Nodejs-SDK
  - type: Sandbox
    url: https://whatsappbusiness.com/developers/developer-hub/
  - type: Media Reference
    url: https://developers.facebook.com/documentation/business-messaging/whatsapp/business-phone-numbers/media
  - type: Phone Numbers Reference
    url: https://developers.facebook.com/documentation/business-messaging/whatsapp/business-phone-numbers/phone-numbers
  - type: Business Profiles Reference
    url: https://developers.facebook.com/documentation/business-messaging/whatsapp/business-phone-numbers/business-profiles
  - type: Two-Step Verification
    url: https://developers.facebook.com/documentation/business-messaging/whatsapp/business-phone-numbers/two-step-verification
  - type: Versioning
    url: https://developers.facebook.com/docs/graph-api/guides/versioning
  - type: JSONSchema
    url: json-schema/whatsapp-message-template-schema.json
  - type: PostmanCollection
    url: https://www.postman.com/meta/whatsapp-business-platform/collection/3kru5r6/whatsapp-business-management-api
  - type: Reference
    url: https://developers.facebook.com/documentation/business-messaging/whatsapp/templates/overview
- aid: whatsapp:whatsapp-business-profile-api
  name: WhatsApp Business Profile API
  description: Get and update WhatsApp Business profile information
  humanURL: https://developers.facebook.com/documentation/business-messaging/whatsapp/overview
  baseURL: https://graph.facebook.com/v21.0
  tags:
  - Business Profile
  properties:
  - type: OpenAPI
    url: openapi/whatsapp-business-profile-api-openapi.yml
  - type: Documentation
    url: https://developers.facebook.com/documentation/business-messaging/whatsapp/about-the-platform
  - type: Authentication
    url: https://developers.facebook.com/documentation/business-messaging/whatsapp/get-started
  - type: Documentation
    url: https://developers.facebook.com/documentation/business-messaging/whatsapp/webhooks/overview
  - type: AsyncAPI
    url: asyncapi/whatsapp-webhooks-asyncapi.yml
  - type: JSONSchema
    url: json-schema/whatsapp-message-schema.json
  - type: Reference
    url: https://developers.facebook.com/documentation/business-messaging/whatsapp/reference/whatsapp-business-phone-number/message-api
  - type: GettingStarted
    url: https://developers.facebook.com/documentation/business-messaging/whatsapp/get-started
  - type: Pricing
    url: https://developers.facebook.com/documentation/business-messaging/whatsapp/pricing
  - type: RateLimits
    url: https://developers.facebook.com/documentation/business-messaging/whatsapp/about-the-platform#throughput
  - type: StatusPage
    url: https://metastatus.com/
  - type: ChangeLog
    url: https://developers.facebook.com/documentation/business-messaging/whatsapp/changelog
  - type: ErrorCodes
    url: https://developers.facebook.com/documentation/business-messaging/whatsapp/support/error-codes
  - type: PostmanCollection
    url: https://www.postman.com/meta/whatsapp-business-platform/collection/wlk6lh4/whatsapp-cloud-api
  - type: Node.js SDK
    url: https://github.com/WhatsApp/WhatsApp-Nodejs-SDK
  - type: Sandbox
    url: https://whatsappbusiness.com/developers/developer-hub/
  - type: Media Reference
    url: https://developers.facebook.com/documentation/business-messaging/whatsapp/business-phone-numbers/media
  - type: Phone Numbers Reference
    url: https://developers.facebook.com/documentation/business-messaging/whatsapp/business-phone-numbers/phone-numbers
  - type: Business Profiles Reference
    url: https://developers.facebook.com/documentation/business-messaging/whatsapp/business-phone-numbers/business-profiles
  - type: Two-Step Verification
    url: https://developers.facebook.com/documentation/business-messaging/whatsapp/business-phone-numbers/two-step-verification
  - type: Versioning
    url: https://developers.facebook.com/docs/graph-api/guides/versioning
  - type: JSONSchema
    url: json-schema/whatsapp-message-template-schema.json
  - type: PostmanCollection
    url: https://www.postman.com/meta/whatsapp-business-platform/collection/3kru5r6/whatsapp-business-management-api
  - type: Reference
    url: https://developers.facebook.com/documentation/business-messaging/whatsapp/templates/overview
- aid: whatsapp:whatsapp-lifecycle-api
  name: WhatsApp Lifecycle API
  description: Publish and deprecate flows
  humanURL: https://developers.facebook.com/documentation/business-messaging/whatsapp/overview
  baseURL: https://graph.facebook.com/v21.0
  tags:
  - Lifecycle
  properties:
  - type: OpenAPI
    url: openapi/whatsapp-lifecycle-api-openapi.yml
  - type: Documentation
    url: https://developers.facebook.com/documentation/business-messaging/whatsapp/about-the-platform
  - type: Authentication
    url: https://developers.facebook.com/documentation/business-messaging/whatsapp/get-started
  - type: Documentation
    url: https://developers.facebook.com/documentation/business-messaging/whatsapp/webhooks/overview
  - type: AsyncAPI
    url: asyncapi/whatsapp-webhooks-asyncapi.yml
  - type: JSONSchema
    url: json-schema/whatsapp-message-schema.json
  - type: Reference
    url: https://developers.facebook.com/documentation/business-messaging/whatsapp/reference/whatsapp-business-phone-number/message-api
  - type: GettingStarted
    url: https://developers.facebook.com/documentation/business-messaging/whatsapp/get-started
  - type: Pricing
    url: https://developers.facebook.com/documentation/business-messaging/whatsapp/pricing
  - type: RateLimits
    url: https://developers.facebook.com/documentation/business-messaging/whatsapp/about-the-platform#throughput
  - type: StatusPage
    url: https://metastatus.com/
  - type: ChangeLog
    url: https://developers.facebook.com/documentation/business-messaging/whatsapp/changelog
  - type: ErrorCodes
    url: https://developers.facebook.com/documentation/business-messaging/whatsapp/support/error-codes
  - type: PostmanCollection
    url: https://www.postman.com/meta/whatsapp-business-platform/collection/wlk6lh4/whatsapp-cloud-api
  - type: Node.js SDK
    url: https://github.com/WhatsApp/WhatsApp-Nodejs-SDK
  - type: Sandbox
    url: https://whatsappbusiness.com/developers/developer-hub/
  - type: Media Reference
    url: https://developers.facebook.com/documentation/business-messaging/whatsapp/business-phone-numbers/media
  - type: Phone Numbers Reference
    url: https://developers.facebook.com/documentation/business-messaging/whatsapp/business-phone-numbers/phone-numbers
  - type: Business Profiles Reference
    url: https://developers.facebook.com/documentation/business-messaging/whatsapp/business-phone-numbers/business-profiles
  - type: Two-Step Verification
    url: https://developers.facebook.com/documentation/business-messaging/whatsapp/business-phone-numbers/two-step-verification
  - type: Versioning
    url: https://developers.facebook.com/docs/graph-api/guides/versioning
  - type: JSONSchema
    url: json-schema/whatsapp-message-template-schema.json
  - type: PostmanCollection
    url: https://www.postman.com/meta/whatsapp-business-platform/collection/3kru5r6/whatsapp-business-management-api
  - type: Reference
    url: https://developers.facebook.com/documentation/business-messaging/whatsapp/templates/overview
- aid: whatsapp:whatsapp-media-api
  name: WhatsApp Media API
  description: Upload, retrieve, and delete media files
  humanURL: https://developers.facebook.com/documentation/business-messaging/whatsapp/overview
  baseURL: https://graph.facebook.com/v21.0
  tags:
  - Media
  properties:
  - type: OpenAPI
    url: openapi/whatsapp-media-api-openapi.yml
  - type: Documentation
    url: https://developers.facebook.com/documentation/business-messaging/whatsapp/about-the-platform
  - type: Authentication
    url: https://developers.facebook.com/documentation/business-messaging/whatsapp/get-started
  - type: Documentation
    url: https://developers.facebook.com/documentation/business-messaging/whatsapp/webhooks/overview
  - type: AsyncAPI
    url: asyncapi/whatsapp-webhooks-asyncapi.yml
  - type: JSONSchema
    url: json-schema/whatsapp-message-schema.json
  - type: Reference
    url: https://developers.facebook.com/documentation/business-messaging/whatsapp/reference/whatsapp-business-phone-number/message-api
  - type: GettingStarted
    url: https://developers.facebook.com/documentation/business-messaging/whatsapp/get-started
  - type: Pricing
    url: https://developers.facebook.com/documentation/business-messaging/whatsapp/pricing
  - type: RateLimits
    url: https://developers.facebook.com/documentation/business-messaging/whatsapp/about-the-platform#throughput
  - type: StatusPage
    url: https://metastatus.com/
  - type: ChangeLog
    url: https://developers.facebook.com/documentation/business-messaging/whatsapp/changelog
  - type: ErrorCodes
    url: https://developers.facebook.com/documentation/business-messaging/whatsapp/support/error-codes
  - type: PostmanCollection
    url: https://www.postman.com/meta/whatsapp-business-platform/collection/wlk6lh4/whatsapp-cloud-api
  - type: Node.js SDK
    url: https://github.com/WhatsApp/WhatsApp-Nodejs-SDK
  - type: Sandbox
    url: https://whatsappbusiness.com/developers/developer-hub/
  - type: Media Reference
    url: https://developers.facebook.com/documentation/business-messaging/whatsapp/business-phone-numbers/media


# --- truncated at 32 KB (135 KB total) ---
# Full source: https://artifacts.apis.io/whatsapp/apis.yml

WhatsApp API — frequently asked questions

Does WhatsApp have an API?

Yes. APIs.io lists 74 APIs from WhatsApp, including WhatsApp Flows API, WhatsApp On-Premises API and WhatsApp Analytics API, and 71 more.

Is there an OpenAPI specification for the WhatsApp API?

Yes. APIs.io indexes 73 OpenAPI specifications for WhatsApp, each linked for download from this page.

How do I authenticate with the WhatsApp API?

WhatsApp documents its authentication (http · 1 scheme). The details are profiled on APIs.io as Whatsapp Authentication.

How much does the WhatsApp API cost?

WhatsApp publishes its prices; its Meta Business Agent messages plan is One global rate of $2.00 USD per 1 million (M) tokens. per 1M tokens as of 2026-10-28. APIs.io lists 2 pricing plans for WhatsApp, with each plan's price, limits and inclusions under Pricing on this page.

Does WhatsApp have an MCP server?

Yes. APIs.io lists 1 MCP server for WhatsApp: Remote MCP server at mcp.facebook.com over streamable HTTP requiring OAuth; 18 tools listed.

Is the WhatsApp API ready for AI agents?

WhatsApp has a Kin Score of 68.0 out of 100 (exemplar) and an Agent Readiness score of 48.0 (agent-ready), scored by API Evangelist on 2026-11-06.

Work with this as data

Every provider 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 providers

9 MCP tools reach this

find_providersBrowse and filter every provider in the catalog.
get_provider_artifactsEvery artifact this provider publishes, grouped by type.
get_provider_operationsEvery operation across all of their OpenAPIs — one call instead of parsing every spec.
get_provider_toolsEvery MCP tool they ship, with the operation each wraps.
get_provider_evidenceHow each part of their score was established. Free — the basis for a claim should not sit behind it.
get_provider_ratingPRO — composite, band, trend and facet scores.
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 provider

curl "https://apis.io/api/v1/providers/whatsapp"

All providers

curl "https://apis.io/api/v1/providers?limit=25"

Every operation they expose

curl "https://apis.io/api/v1/providers/whatsapp/operations?limit=25"

How their score was established

curl "https://apis.io/api/v1/providers/whatsapp/evidence"

Calls without X-API-Key need no key. Calls with it need a paid plan — get a key.

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.