Sign in

v77

latestOpenAPI 3.1.0MITraw.githubusercontent.com2026-08-012528701.8 MB
WhatsApp Templates

Update a message template

Updates a template's category or components. A template can only be updated while it is not yet approved — once approved, delete and recreate it to make changes.

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.

patch/api/messaging/whatsapp/templates/{id}

Path parameters

idstring required

The template ID — either the SignalWire ID (a UUID) or the Meta template ID (a numeric string). Both are accepted.

Request body

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

The category of a WhatsApp message template.

Example request

{
  "components": [
    {
      "type": "BODY"
    }
  ]
}

Response

The request has succeeded.

idstring uuid required

Universal Unique Identifier.

namestring required

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

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

The category of a WhatsApp message template.

languagestring required

The template language code.

parameter_format'named' | 'positional' required

How a template's variable placeholders are referenced.

template_idstring required

Meta's identifier for the template.

template_status'approved' | 'archived' | 'deleted' | 'disabled' | 'flagged' | 'in_appeal' | 'limit_exceeded' | 'locked' | 'paused' | 'pending' | 'reinstated' | 'pending_deletion' | 'rejected' required

The Meta approval status of a template. A template must be approved before it can be used to send messages.

whatsapp_business_idstring uuid required

Universal Unique Identifier.

created_atstring required

The date and time when the template was created.

updated_atstring required

The date and time when the template was last updated.

discarded_atstring

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

Example response

{
  "name": "order_update",
  "components": [
    {
      "type": "BODY"
    }
  ],
  "language": "en_US",
  "template_id": "1164792772433648",
  "created_at": "2024-01-15T10:30:00Z",
  "updated_at": "2024-01-15T10:30:00Z",
  "discarded_at": "2024-01-15T10:30:00Z"
}