Get Templates List

Retrieve the complete list of WhatsApp templates configured for your account. This endpoint returns all templates with their approval status, structure, components, and variable placeholders—allowing you to identify which templates are ready to use and understand their exact format before sending messages.

Use this endpoint to:

View all available templates with their IDs, categories (MARKETING, UTILITY, AUTHENTICATION), and approval status

Inspect template components (HEADER, BODY, FOOTER, BUTTONS) and variable placeholders ({{1}}, {{2}}, etc.)

Verify which templates are approved and ready for messaging

Preview example data and media references

Key points:

Only templates with "status": "approved" can be used in live messaging

Template structure in your API request must exactly match the components and variable order

Body variables ({{1}}, {{2}}, {{3}}) must be provided in positional order

Media headers require valid, publicly accessible URLs

Template language must match

💡

Implementation Notes:

Match the exact structure: Your messaging API payload must include components in the same order as the template (HEADER → BODY → BUTTONS).

Body variables are positional: BODY: ["value1", "value2"] fills {{1}} and {{2}} in sequence.

Headers are optional: Only include HEADER if the template has a header component. For media headers, provide a valid public URL.

Button payloads vs labels: BUTTONS[] values are tracking payloads, not the visible button text shown to users.

Filter by status and language: Use only approved templates in the correct language to avoid API failures.

Provide your bearer token in the

Authorization

header when making requests to protected resources.

Example:

Authorization: Bearer ********************

Request

Request Code Samples

Responses