Templates
Message templates are pre-approved formats you can send at any time, including outside the 24-hour window.
- GET
/v1/templatesList templates (?status, ?category, ?q, ?messaging_account_id)templates:read - POST
/v1/templatesCreate, and by default submit to Metatemplates:write - GET
/v1/templates/{id}templates:read - PATCH
/v1/templates/{id}Edit and resubmittemplates:write - DELETE
/v1/templates/{id}Delete here and on Metatemplates:write - POST
/v1/templates/syncPull the latest from Meta → { synced }templates:write - POST
/v1/templates/upload-sampleUpload a header sample → { handle, mime }templates:write
The template object
{
"id": "3c7d…",
"messaging_account_id": "5b8e…",
"name": "order_shipped",
"language": "en",
"category": "UTILITY",
"sub_category": null,
"previous_category": null,
"status": "APPROVED",
"rejected_reason": null,
"quality_score": "GREEN",
"parameter_format": "POSITIONAL",
"meta_template_id": "1234567890",
"message_send_ttl_seconds": null,
"components": [
{ "type": "HEADER", "format": "IMAGE", "example": { "header_handle": ["https://…"] } },
{ "type": "BODY", "text": "Hi {{1}}, your order {{2}} has shipped!",
"example": { "body_text": [["Jane", "#48213"]] } },
{ "type": "FOOTER", "text": "Example Store" },
{ "type": "BUTTONS", "buttons": [
{ "type": "URL", "text": "Track order", "url": "https://example.com/t/{{1}}", "example": ["https://example.com/t/48213"] }
] }
],
"created_at": "2026-11-10T08:15:00Z",
"updated_at": "2026-11-11T10:42:00Z"
}components uses Meta's template component schema, so anything you build in Engage maps 1:1 to WhatsApp Manager. The list returns { "data": [...] } (up to 1,000 templates, no cursor); deleted templates are hidden. Keys with messages:send can also list templates.
Creating a template
namestringrequiredLowercase letters, numbers and underscores; up to 512 characters.languagestringrequiredLocale code such asen,en_US,hi(up to 10 characters).categoryenumrequiredMARKETING·UTILITY·AUTHENTICATIONparameter_formatenumoptionalPOSITIONAL({{1}}, the default) orNAMED({{first_name}}).componentsarrayrequiredHeader, body, footer, buttons, carousel components with examples.submitbooleanoptionalSubmit to Meta for review now (defaulttrue).falsesaves a draft.messaging_account_iduuidoptionalWhich WhatsApp Business Account to create it in, if you have more than one.allow_category_changebooleanoptionalLet Meta re-categorise the template instead of rejecting it.message_send_ttl_secondsintegeroptionalHow long WhatsApp keeps trying to deliver messages using this template.
Creating a template with a name and language that already exist on the account updates that template. The response is 201 with the template object.
Media header samples
Templates with an IMAGE, VIDEO or DOCUMENT header need an example file. Upload it with POST /v1/templates/upload-sample (multipart file: JPEG/PNG up to 5 MB, MP4 up to 16 MB, PDF up to 100 MB) and put the returned handle in the header's example.header_handle.
Editing and deleting
PATCHacceptscomponents,category,message_send_ttl_secondsandsubmit(defaulttrue, so patching a draft submits it).- Once a template is on Meta, only
APPROVED,REJECTEDorPAUSEDtemplates can be edited; the template goes back toPENDINGfor review. DELETEremoves the template on Meta too. It is refused with422while a scheduled or sending campaign uses it.
Limits
Statuses
template.status webhook to be notified when Meta approves, rejects or pauses a template, and template.quality for quality changes.