Camille last wrote to her repair shop two days ago, so the shop can no longer message her freely. To tell her the bike is ready, it sends a message template: a message Meta reviews before a business sends it outside a conversation's reply window.
A workspace's templates are those of the business account its WhatsApp connection links. Heythere submits the templates it creates to Meta, and keeps every template of the account in sync, including those created in Meta's tools.
What does a review state mean?
reviewState | Meaning |
|---|---|
pending_review | Meta is reviewing the template. |
approved | The template can be sent. |
rejected | Meta refused the template; reason says why. |
paused | Meta paused the template because of its quality rating. |
disabled | Meta disabled the template. |
in_appeal | Meta is reviewing an appeal of its rejection. |
archived | Meta archived the unused template; unarchive it in WhatsApp Manager. |
unrecognized | Meta reports a state Heythere does not know yet. |
Which rules does a template follow?
A
nameis unique per language in the business account, and a template'snameandlanguagenever change.A
categoryismarketing,utility, orauthentication, and Meta may move a template betweenmarketingandutility.A variable is written
{{name}}, such as{{order_number}}, and needs an example for Meta's review.A
standardtemplate has an optional header, a body, an optional footer, and buttons. Acarouseltemplate has a body and cards. Anauthenticationtemplate sends a one-time code.
A template can be edited while it is approved, rejected, or paused, and Meta limits how often an approved template changes.
How does an automation send a template?
A send_template step names an approved template and gives each of its variables a value, such as {{run.first_name}}, and sends even after the reply window closed. A template it cannot send, such as one with a media header, fails the run.
In the API
Every operation is a REST endpoint and, unless marked REST only, an MCP tool of the same name. The OpenAPI document describes their parameters, payloads, and errors.
- POST
createWhatsAppMessageTemplateCreate a WhatsApp message template
/api/organizations/{organizationId}/workspaces/{workspaceId}/whatsapp/message-templates - GET
listWhatsAppMessageTemplatesList WhatsApp message templates
/api/organizations/{organizationId}/workspaces/{workspaceId}/whatsapp/message-templates - GET
getWhatsAppMessageTemplateGet a WhatsApp message template
/api/organizations/{organizationId}/workspaces/{workspaceId}/whatsapp/message-templates/{messageTemplateId} - PATCH
updateWhatsAppMessageTemplateUpdate a WhatsApp message template
/api/organizations/{organizationId}/workspaces/{workspaceId}/whatsapp/message-templates/{messageTemplateId} - DELETE
deleteWhatsAppMessageTemplateDelete a WhatsApp message template
/api/organizations/{organizationId}/workspaces/{workspaceId}/whatsapp/message-templates/{messageTemplateId}