Skip to main content
WhatsApp message templates are pre-approved message formats you manage through Connectly and Meta’s WhatsApp Manager. Because Meta approves them in advance, templates can be sent to any customer at any time — including first-time contacts and those outside the 24-hour session window.
Once a template is approved, use it to send messages via Send template message.

​
Template categories

Every template must belong to one of three categories:

​
Template components

A template is built from template_components — an ordered list of component objects. Each component is one of: header, body, footer, or button. Template headers support four types:

​
Body

The main text of the template. Supports variables using {{N}} syntax — {{1}}, {{2}}, {{3}}, etc., numbered sequentially from 1 to 15.
Variables must be numbered sequentially from 1. You cannot skip numbers or use duplicates. For example, {{1}}, {{2}}, {{3}} is valid; {{1}}, {{3}} is not.
Optional plain text displayed below the body. Does not support variables.

​
Buttons

Up to 3 buttons per template. Three types are supported:
You cannot mix Quick Reply and Call-to-Action buttons in the same template. Use up to 3 Quick Reply buttons or Call-to-Action buttons (URL and/or phone) — not both.
Carousel templates display multiple cards in a horizontally scrollable format. Each card has its own header image, body text, and buttons. Create a carousel template by including a carousel component in template_components. See Create template for the full payload structure.

​
Approval process

After you submit a template via the Create template endpoint, Meta reviews it automatically. Templates are typically approved within 5 minutes but can take up to 24 hours. The template status starts as MESSAGE_TEMPLATE_STATUS_PENDING and transitions to approved or rejected. Check the current status of your templates at any time using Get templates.
Media size limits apply to template headers. See Meta’s media documentation for the full list of constraints.

​
Next steps

Create template

Submit a new template to Meta for review.

Send template message

Use an approved template to send a message.