Sign in
WhatsApp

Create a WhatsApp template

Creates a WhatsApp template for the sender identified by number and submits it for provider review.

post/v1/whatsapp/senders/{number}/templates

Path parameters

numberstring required
Example:14155550100

Sender's phone number, digits only.

Request body

namestring required

Template name.

languagestring required

Template language code.

category'marketing' | 'authentication' | 'utility' required

Template category.

Example request

{
  "name": "order_shipped",
  "language": "en_US",
  "category": "utility",
  "components": [
    {
      "type": "BODY",
      "format": "TEXT",
      "text": "Your order {{1}} has shipped."
    }
  ]
}

Response

The newly created WhatsApp template.

Example response

{
  "template": {
    "uuid": "3a525ca2-6909-4c72-9399-905adf7f3a74",
    "name": "order_shipped",
    "language": "en_US",
    "category": "utility",
    "status": "approved",
    "quality_rating": "high",
    "submitted_at": "2026-01-15T10:30:00Z",
    "components": [
      {
        "type": "BODY",
        "format": "TEXT",
        "text": "Your order {{1}} has shipped."
      }
    ],
    "created_at": "2026-01-10T09:00:00Z"
  }
}

Changes

Changed in 1 of the 55 revisions of this API.1