WhatsApp Templates

WhatsApp requires pre-approved templates to start conversations. Templates use positional {{1}}, {{2}} placeholders filled with variables at send time. Create a draft, submit it for Meta approval, then send it once approved.

Create Template

POST
/v1/whatsapp/templates

Create a draft template. Variables must run sequentially from {{1}}.

Parameters

ParameterTypeDescription
namerequiredstringLowercase letters, digits, underscores (e.g. order_confirmation). Unique per language.
bodyrequiredstringTemplate text with positional {{n}} placeholders.
categorystringOne of: marketing, utility (default), authentication.
languagestringBCP-47 language tag (default "en").
componentsobjectOptional full Meta component definition (header/body/footer/buttons).

Example Response

{
  "id": "d290f1ee-6c54-4b01-90e6-d701748f0851",
  "name": "order_confirmation",
  "language": "en",
  "category": "utility",
  "status": "draft",
  "body": "Hi {{1}}, your order {{2}} shipped.",
  "variableCount": 2,
  "providerRef": null,
  "rejectionReason": null,
  "createdAt": "2026-06-04T10:00:00Z",
  "updatedAt": "2026-06-04T10:00:00Z"
}

List Templates

GET
/v1/whatsapp/templates

List all WhatsApp templates for the current team.

Get Template

GET
/v1/whatsapp/templates/{id}

Retrieve a single template by ID.

Update Template

PATCH
/v1/whatsapp/templates/{id}

Update a draft or rejected template's body, category, language, or components. Submitted/approved templates are locked.

Delete Template

DELETE
/v1/whatsapp/templates/{id}

Delete a template. Past messages that used it keep their history.

Submit for Approval

POST
/v1/whatsapp/templates/{id}/submit

Submit a draft or rejected template to Meta for approval. Moves it to submitted.

Template Status Lifecycle

  • draftEditable. Submit when ready.
  • submittedAwaiting Meta review. Locked from edits.
  • approvedApproved by Meta — ready to send.
  • rejectedRejected by Meta. Check rejectionReason; edit and resubmit.
  • disabledDisabled by Meta (e.g. quality drop). No longer sendable.