Skip to main content
List Whatsapp Templates
name is what goes in an agent’s builtin_tools.send_whatsapp_template.allowed_templates.
Check a name here before you set it. allowed_templates accepts any string, so a typo is stored without complaint and the agent then cannot send - with nothing in the response to say why. This is the list to compare against.

Only approved templates

WhatsApp reviews every template before it can be sent. This endpoint returns the ones that passed. All four mean the same thing to an agent - it cannot send with them - so offering them would invite exactly the silent failure above.

A name is not unique on its own

The same template can be approved in several languages, so a row is a name and a language:
allowed_templates takes the name. Which language is sent is decided at send time from the conversation, not here. category is what WhatsApp classified the template as - UTILITY, MARKETING or AUTHENTICATION - which decides when it may be sent. It is null until they have classified it. Creating a template and submitting it for review are dashboard actions.

Authorizations

Authorization
string
header
required

Your API key as a Bearer token, e.g. Authorization: Bearer vk_….

Response

Approved templates you can name in allowed_templates.

name
string

What goes in builtin_tools.send_whatsapp_template.allowed_templates.

language
string

The language this template was approved in, e.g. en or hi. The same name can be approved in several, which is why a row is a name and a language together.

category
string | null

MARKETING, UTILITY or AUTHENTICATION — what WhatsApp classified it as, which decides when it may be sent. Null until they have classified it.