Skip to main content
POST
Create a new custom WhatsApp message template. The template record is saved locally with initial status PENDING and asynchronously dispatched to Meta Graph API v19.0 under your connected WhatsApp Business Account (WABA).

Authentication

This endpoint requires Bearer token authentication.

Input parameters

The following parameters are accepted in the JSON request body.
string
required
Bearer token for authentication. Format: Bearer <token>.
string
required
UUID of the registered WhatsApp Business phone number channel in Sayvy AI.
string
required
Template identifier name on Meta (lowercase alphanumeric with underscores, maximum 255 characters). Example: summer_promo_2026.
string
required
Language code (e.g. en_US, es_ES, pt_BR).
string
required
Template category:
  • MARKETING: Promotional messages, lead offers, discounts.
  • UTILITY: Order confirmations, delivery updates, receipts.
  • AUTHENTICATION: OTP and two-factor authorization codes.
object[]
required
Structured array of template components (HEADER, BODY, FOOTER, BUTTONS):

Response Fields

string
Generated UUID identifier of the template in Sayvy AI.
string
UUID of the associated WhatsApp channel.
string
WhatsApp Business Account (WABA) identifier on Meta.
string
Meta’s remote template ID (assigned upon Meta confirmation).
string
Template unique name.
string
BCP-47 language tag (e.g. en_US).
string
Template category (MARKETING, UTILITY, AUTHENTICATION).
string
Current review status: PENDING, APPROVED, or REJECTED.
object[]
Array of configured components.
string
Meta quality score rating (GREEN, YELLOW, RED, or empty).
string
ISO 8601 creation timestamp.
string
ISO 8601 modification timestamp.


Previous
List templates
GET /api/v1/templates
Next