WAwavix
WhatsApp

Create a WhatsApp template

Changed on

Creates a WhatsApp template in one of your account's WhatsApp Business Accounts, submits it for review, and returns the new template.

Every WhatsApp message you send uses a template, so new message content starts with a new template.

Behavior: Returns 201 with the new template. Poll whatsapp_templates_get for the review outcome. Returns 409 when the WhatsApp Business Account already has a template with the same name and language.

Requires: Your account must have WhatsApp and its templates capability enabled, must have a subscription plan, and must not be blocked or suspended. The WhatsApp Business Account must have a connected sender; when your account has more than one WhatsApp Business Account, specify waba_id or sender.

post/v1/whatsapp/templates

Request

  • Base URL
    https://api.wavix.com
  • URL
    https://api.wavix.com/v1/whatsapp/templates
  • Auth
    HTTP bearer

Request body

namestring required

Template name, made of lowercase letters, digits, and underscores, up to 512 characters.

languagestring required

Template language code, such as en or en_US.

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

Template category. Possible values:

  • marketing — Promotions, offers, and other marketing content.
  • authentication — One-time passcodes for verifying a user.
  • utility — Transactional updates about an order or an account.
waba_idstring

ID of the WhatsApp Business Account that owns the template, as returned in waba.id by whatsapp_senders_list. Required when your account has more than one, unless sender is set. When both are set, sender must belong to this WhatsApp Business Account.

senderstring

Phone number of a connected sender whose WhatsApp Business Account owns the template, as an alternative to waba_id. When both are set, the sender must belong to waba_id. The leading + is optional.

Example request

{
  "name": "order_shipped",
  "language": "en_US",
  "category": "utility",
  "components": [
    {
      "text": "Order {{1}}",
      "example": {
        "header_text": [
          "#1001"
        ]
      }
    }
  ],
  "waba_id": "102290129340398",
  "sender": "14155550100"
}

Response

The created WhatsApp template.

Example response

{
  "template": {
    "uuid": "6b1f3c52-9e0a-4d7b-8a15-c2f4e9d07b38",
    "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": "Hi {{1}}, your order {{2}} has shipped."
      }
    ],
    "waba": {
      "id": "102290129340398",
      "name": "Acme Support"
    },
    "created_at": "2026-01-15T10:30:00Z"
  }
}

Changes