Sign in

v51

latestOpenAPI 3.0.3raw.githubusercontent.com2026-08-02172186551.1 KB

Create template

Create a WhatsApp message template. Note: Templates must be approved by Meta before use.

post/v1/templates

Request body

namestring required
languagestring required
bodystring required

Default template body. Used when no channel-specific body is set.

smsBodystring

Channel-specific body for SMS. Falls back to body if not set.

telegramBodystring

Channel-specific body for Telegram. Falls back to body if not set.

instagramBodystring

Channel-specific body for Instagram. Falls back to body if not set.

whatsappCategory'UTILITY' | 'MARKETING' | 'AUTHENTICATION'

WhatsApp template category.

headerType'text' | 'image' | 'video' | 'document'

Type of header for the template.

headerContentstring

Header content (text string or media URL).

footerstring

Footer text for the template.

variablesstring[]
addSecurityRecommendationboolean

Add 'Do not share this code' disclaimer. Only for AUTHENTICATION templates.

codeExpirationMinutesinteger

Code expiration time in minutes. Only for AUTHENTICATION templates.

Example request

{
  "buttons": [
    {
      "example": "ORD-12345"
    }
  ]
}

Response

Template created.

idstring required
namestring required

Template name. For WhatsApp, must match the approved template name in Meta.

languagestring required

Language code.

bodystring required

Default template body with variables: positional ({{1}}, {{2}}) or named ({{customer_name}}, {{contact.first_name}}). Templates created in Zavu are submitted to Meta as positional; templates imported from a WhatsApp Business Account keep their original format (named or positional). Used when no channel-specific body is set.

smsBodystring

Channel-specific body for SMS messages. Falls back to body if not set.

telegramBodystring

Channel-specific body for Telegram messages. Falls back to body if not set.

instagramBodystring

Channel-specific body for Instagram messages. Falls back to body if not set.

category'UTILITY' | 'MARKETING' | 'AUTHENTICATION' required

WhatsApp template category.

status'draft' | 'pending' | 'approved' | 'rejected'
variablesstring[]

List of variable names for documentation.

headerTypestring

Type of header (text, image, video, document).

headerContentstring

Header content (text or media URL).

footerstring

Footer text for the template.

addSecurityRecommendationboolean

Add 'Do not share this code' disclaimer. Only for AUTHENTICATION templates.

codeExpirationMinutesinteger

Code expiration time in minutes. Only for AUTHENTICATION templates.

createdAtstring date-time
updatedAtstring date-time

Example response

{
  "name": "order_confirmation",
  "language": "en",
  "body": "Hi {{1}}, your order {{2}} has shipped."
}