Create a message template

POST

https://{your_space_name}.signalwire.com/api/messaging/whatsapp/templates

POST

/api/messaging/whatsapp/templates

curl -X POST https://{your_space_name}.signalwire.com/api/messaging/whatsapp/templates \
     -H "Content-Type: application/json" \
     -u "<project_id>:<api_token>" \
     -d '{
  "whatsapp_business_id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
  "name": "order_update",
  "language": "en_US",
  "category": "utility",
  "parameter_format": "positional",
  "components": [
    {
      "type": "HEADER",
      "example": {
        "header_text": [
          "Jane Smith"
        ]
      },
      "format": "TEXT",
      "text": "Order Update for {{1}}"
    },
    {
      "type": "BODY",
      "example": {
        "body_text": [
          [
            "ORD-9821",
            "out for delivery"
          ]
        ]
      },
      "text": "Your order {{1}} is currently {{2}}."
    },
    {
      "type": "FOOTER",
      "text": "Thank you for shopping with us."
    },
    {
      "type": "BUTTONS",
      "buttons": [
        {
          "text": "Track Order",
          "type": "QUICK_REPLY"
        },
        {
          "text": "Contact Support",
          "type": "URL",
          "url": "https://example.com/support"
        }
      ]
    }
  ]
}'

{
  "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
  "name": "order_update",
  "category": "utility",
  "components": [
    {
      "type": "BODY"
    }
  ],
  "language": "en_US",
  "parameter_format": "positional",
  "template_id": "1164792772433648",
  "template_status": "approved",
  "whatsapp_business_id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
  "created_at": "2024-01-15T10:30:00Z",
  "updated_at": "2024-01-15T10:30:00Z",
  "discarded_at": "2024-01-15T10:30:00Z"
}

Permissions

The API token used to authenticate must have the following scope(s) enabled to make a successful request: Numbers.

Learn more about API scopes.

Creates a WhatsApp message template under a connected Business Account and submits it to Meta for review. Use it when outbound content must be sent outside the 24-hour customer service window. Approval typically takes from a few minutes to a few hours; poll the template until `template_status` becomes `approved`, then send it through [Send a message](/docs/apis/rest/messages/create-message). #### Permissions The API token used to authenticate must have the following scope(s) enabled to make a successful request: _Numbers_. [Learn more about API scopes](/docs/platform/your-signalwire-api-space).

Authentication

AuthorizationBasic

SignalWire Basic Authentication using Project ID and API Token.

The client sends HTTP requests with the Authorization header containing the word Basic followed by a space and a base64-encoded string of project_id:token. The project ID will be used as the username and the API token as the password.

Example:

Authorization: Basic base64(project_id:token)

SignalWire Basic Authentication using Project ID and API Token. The client sends HTTP requests with the Authorization header containing the word Basic followed by a space and a base64-encoded string of project_id:token. The project ID will be used as the username and the API token as the password. Example: ``` Authorization: Basic base64(project_id:token) ```

Request

This endpoint expects an object.

whatsapp_business_idstringRequiredformat: "uuid"

The WhatsApp Business Account the template belongs to. List your accounts at GET /api/messaging/whatsapp/businesses.

namestringRequiredformat: "^[a-z0-9_]*$"<=512 characters

The template name. Maximum 512 characters; lowercase letters, numbers, and underscores only.

languagestringRequired

The template language code.

categoryenumRequired

The template category.

parameter_formatenumRequired

How the template's variable placeholders are referenced.

componentslist of objectsRequired

The template’s components. Must include a BODY component. Each component is an object whose fields depend on its type — see the request example.

Response

Response returned when a template is successfully created and submitted to Meta.

idstringformat: "uuid"

The SignalWire identifier of the template.

namestring

The template name. Lowercase letters, numbers, and underscores only.

categoryenum

The template category.

componentslist of objects

The template’s components (header, body, footer, buttons).

languagestring

The template language code.

parameter_formatenum

How the template's variable placeholders are referenced.

template_idstring

Meta's identifier for the template.

template_statusenum

The Meta approval status of the template.

whatsapp_business_idstringformat: "uuid"

The SignalWire identifier of the WhatsApp Business Account the template belongs to.

created_atstring

The date and time when the template was created.

updated_atstring

The date and time when the template was last updated.

discarded_atstringOptional

The date and time when the template was discarded, if applicable.

Errors

400

Bad Request Error

401

Unauthorized Error

422

Unprocessable Entity Error

500

Internal Server Error