Need help with your APIs? I offer API discovery, governance & evangelism services. Explore services →
API Evangelist API Evangelist
Discovery
Learnings
Guidance
Toolbox
Alignment
API Evangelist LLC

WhatsApp Messages API

Send messages of all types to WhatsApp users

WhatsApp Messages API is one of 17 APIs that WhatsApp publishes on the APIs.io network, described by a machine-readable OpenAPI specification and an AsyncAPI event-driven specification.

This API exposes 2 JSON Schema definitions.

Tagged areas include Messages. The published artifact set on APIs.io includes an OpenAPI specification, API documentation, authentication docs, an AsyncAPI specification, an API reference, a getting-started guide, and 2 JSON Schemas.

This API exposes 1 operation across 1 path, and defines 16 schemas. It is described by OpenAPI 3.1.0, at version 21.0.

Requests are made against a single base URL, https://graph.facebook.com/v21.0.

1 operations 1 paths 16 schemas 1 POST

Metadata

The identity and technical contract details declared by the specification.

Specification
OpenAPI 3.1.0
API Version
21.0
Base URL
https://graph.facebook.com/v21.0
Authentication
HTTP Bearer
Terms of Service
Resource Areas
1

Authentication & Security 1

WhatsApp Messages API declares 1 security scheme for authenticating requests. It accepts HTTP bearer tokens (bearerAuth). By default, every request must be authenticated.

  • bearerAuth — System User Token with whatsappbusinessmanagement permission

Paths & Operations 1

Across 1 path, the API surfaces 1 operation — 1 POST. Each is listed below with its method, path, parameters, and response codes.

Messages 1

Send messages of all types to WhatsApp users

POST
/{phone-number-id}/messages
WhatsApp Send a Message
sendMessage 1 param body → 200400401

Schemas 16

The contract defines 16 schemas that model the data the API accepts and returns. The most detailed are SendMessageRequest (19 properties), TemplateParameter (10 properties), ContactObject (7 properties), InteractiveMessage (5 properties). Each schema is shown below with its type and property counts.

SendMessageResponse
object
3 properties
MediaObject
object
3 properties
TextMessage
object
2 properties 1 required
ListSection
object
2 properties
TemplateMessage
object
3 properties 2 required
LocationMessage
object
4 properties 2 required
InteractiveMessage
object
5 properties 2 required
ContactObject
object
7 properties 1 required
TemplateParameter
object
10 properties 1 required
ErrorResponse
object
1 property
DocumentObject
object
4 properties
TemplateComponent
object
4 properties 1 required
SendMessageRequest
object
19 properties 3 required
AudioObject
object
2 properties
ReactionMessage
object
2 properties 2 required
StickerObject
object
2 properties

Specification

The full machine-readable OpenAPI contract behind this narrative.

Source

whatsapp-messages-api-openapi.yml Raw ↑

Other APIs WhatsApp publishes across the network.

WhatsApp Flows API
WhatsApp On-Premises API
WhatsApp Analytics API
WhatsApp Assets API
WhatsApp Assigned Users API
WhatsApp Business Accounts API
WhatsApp Business Profile API
WhatsApp Lifecycle API
WhatsApp Media API
WhatsApp Message Templates API
WhatsApp Phone Numbers API
WhatsApp Product Catalogs API