API ReferenceTemplates

Create a new template

Creates a new message template and submits it to Meta for approval. Templates must be approved before they can be used to send messages.

Authentication

AuthorizationBearer

API Key in the format mk_live_<43-chars>. Obtain from the Dashboard or POST /auth/api-keys.

Request

This endpoint expects an object.
wabaIdstringRequired
WhatsApp Business Account ID to create the template under
namestringRequiredformat: "^[a-z0-9_]+$"
Template name using only lowercase letters, numbers, and underscores
languagestringRequired

Language code for the template (e.g., en_US, es_ES)

categoryenumRequired

Template category as required by Meta: MARKETING, UTILITY, or AUTHENTICATION

Allowed values:
componentslist of maps from strings to anyRequired

Array of template components (header, body, footer, buttons)

Response

Default Response
idstring
Unique identifier of the template in the Muchaw platform
developerIdstring
ID of the developer who owns this template
wabaIdstring
WhatsApp Business Account ID this template belongs to
metaTemplateIdstring
Template ID assigned by Meta
namestring
Template name
languagestring
Language code of the template
categorystring

Template category (MARKETING, UTILITY, or AUTHENTICATION)

statusstring

Approval status of the template (e.g., APPROVED, PENDING, REJECTED)

componentsany
Template components as returned by the WhatsApp Business API
createdAtstring
ISO 8601 datetime when the template was created
updatedAtstring
ISO 8601 datetime when the template was last updated

Errors

400
Bad Request Error
401
Unauthorized Error