Skip to main content
POST
Submit a new WhatsApp template for Meta approval

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Body

application/json
name
string
required
Required string length: 1 - 512
Pattern: ^[a-z0-9_]+$
language
string
required

BCP-47 code, e.g. en_US, ar, ar_SA.

Minimum string length: 1
category
enum<string>
required

UTILITY for a follow-up on something the person already contacted you about; MARKETING for a promotion (opt-out gated, worse delivery). Meta re-categorizes what it disagrees with.

Available options:
UTILITY,
MARKETING,
AUTHENTICATION
body_text
string
required

Placeholders as {{1}}, {{2}} in order, or {{named}}. Never mix the two styles.

Required string length: 1 - 1024
body_variable_examples
string[]

A realistic sample value per placeholder, in body order. Meta REJECTS templates whose placeholders have no examples, so an empty list with a placeholder-bearing body is refused here rather than hours later.

Maximum array length: 20
Minimum string length: 1
header_text
string

Plain text only, no placeholders.

Required string length: 1 - 60
Required string length: 1 - 60
buttons
object[]

In display order. Quick replies must sit together — all before or all after the other kinds (Meta groups them). Up to 10.

Maximum array length: 10
message_send_ttl_seconds
integer

Message validity period in seconds. Authentication: 30–900, Utility: 30–43200, Marketing: 43200–2592000. -1 = explicit 30-day TTL (authentication/utility only).

Required range: -9007199254740991 <= x <= 9007199254740991
waba_id
string

Only needed when the org has more than one WABA; otherwise resolved.

Response

Default Response

id
string
required
name
string
required
language
string
required
status
enum<string>
required
Available options:
APPROVED,
REJECTED,
PENDING,
PAUSED,
DISABLED,
IN_APPEAL,
PENDING_DELETION,
DELETED,
LIMIT_EXCEEDED,
ARCHIVED
category
enum<string>
required

What Meta FILED it as, which may differ from what was requested.

Available options:
UTILITY,
MARKETING,
AUTHENTICATION
variables
string[]
required
buttons
object[]
required

Which indexes take a step binding — see needs_value.

sendable
boolean
required

Effectively always false on create: Meta review takes minutes to hours. Reference it from a step now — a pending template does not block launch; sends start the moment it clears.