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 Message Templates API

Create, update, and delete message templates

WhatsApp Message Templates 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 Message Templates. 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 4 operations across 2 paths, and defines 6 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.

4 operations 2 paths 6 schemas 1 DELETE1 GET2 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 Message Templates 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 4

Across 2 paths, the API surfaces 4 operations — 1 DELETE, 1 GET, 2 POST. Each is listed below with its method, path, parameters, and response codes.

Message Templates 4

Create, update, and delete message templates

GET
/{waba-id}/message_templates
WhatsApp List Message Templates
listMessageTemplates 9 params → 200
POST
/{waba-id}/message_templates
WhatsApp Create Message Template
createMessageTemplate 1 param body → 200
DELETE
/{waba-id}/message_templates
WhatsApp Delete Message Template
deleteMessageTemplate 3 params → 200
POST
/{message-template-id}
WhatsApp Update Message Template
updateMessageTemplate 1 param body → 200

Schemas 6

The contract defines 6 schemas that model the data the API accepts and returns. The most detailed are TemplateButton (8 properties), MessageTemplate (8 properties), TemplateComponentDefinition (7 properties), CreateTemplateRequest (5 properties). Each schema is shown below with its type and property counts.

MessageTemplate
object
8 properties
TemplateComponentDefinition
object
7 properties 1 required
SuccessResponse
object
1 property
CreateTemplateRequest
object
5 properties 4 required
CursorPaging
object
3 properties
TemplateButton
object
8 properties 2 required

Specification

The full machine-readable OpenAPI contract behind this narrative.

Source

whatsapp-message-templates-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 Messages API
WhatsApp Phone Numbers API
WhatsApp Product Catalogs API