Templates

Returns all approved WhatsApp message templates linked to a given phone number. Each template includes an expected_variables field that tells you exactly which values to pass when sending.

Create templates in the Bahasha Dashboard if you haven’t already.

List templates for a phone number


GET /v1/whatsapp/phone_numbers/:phone_number_id/templates

The :phone_number_id is the id field returned by the Phone Numbers endpoint.

The phone_number_id used in all requests is the id field returned by the Phone Numbers endpoint. This is different from the actual phone number itself.

cURL


curl https://api.bahasha.app/v1/whatsapp/phone_numbers/123456789/templates \
  -H "Authorization: Bearer bh_live_xxxxxxxxxxxx"

JavaScript


const phoneNumberId = "123456789";
 
const response = await fetch(
`https://api.bahasha.app/v1/whatsapp/phone_numbers/${phoneNumberId}/templates`,
{ headers: { "Authorization": "Bearer bh_live_xxxxxxxxxxxx" } }
);
 
const templates = await response.json();
console.log(templates);

Python


import requests
 
phone_number_id = "123456789"
 
response = requests.get(
    f"https://api.bahasha.app/v1/whatsapp/phone_numbers/{phone_number_id}/templates",
    headers={"Authorization": "Bearer bh_live_xxxxxxxxxxxx"},
)
 
print(response.json())

Response


[
  {
    "id": "6643c2a1f4e3b12d5c9a0001",
    "name": "order_confirmation",
    "language": "en_US",
    "category": "UTILITY",
    "status": "APPROVED",
    "components": [
      {
        "type": "BODY",
        "text": "Hi {{customer_name}}, your order {{order_id}} is confirmed."
      }
    ],
    "expected_variables": {
      "header": [],
      "body": [
        { "param_name": "customer_name", "example": "John Doe" },
        { "param_name": "order_id", "example": "ORD-12345" }
      ],
      "buttons": []
    }
  }
]

Key fields

Field	Description
`id`	Use this as `templateId` in all media endpoints.
`name`	Template name — use this as `template_name` when sending
`language`	Language code — use this as `language_code` when sending
`expected_variables`	Object with `header`, `body`, and `buttons` arrays. Each entry has a `param_name` (key to use when sending) and an `example` value.

Get a specific template by name


GET /v1/whatsapp/phone_numbers/:phone_number_id/templates/:templateName

Fetches a single template by its name. Use this when you already know the template name and want its expected_variables without fetching the full list. Template names can be found in the Bahasha dashboard.

cURL


curl https://api.bahasha.app/v1/whatsapp/phone_numbers/123456789/templates/order_confirmation \
  -H "Authorization: Bearer bh_live_xxxxxxxxxxxx"

JavaScript


const phoneNumberId = "123456789";
const templateName = "order_confirmation";
 
const response = await fetch(
`https://api.bahasha.app/v1/whatsapp/phone_numbers/${phoneNumberId}/templates/${templateName}`,
{ headers: { "Authorization": "Bearer bh_live_xxxxxxxxxxxx" } }
);
 
const template = await response.json();
console.log(template);

Python


import requests
 
phone_number_id = "123456789"
template_name = "order_confirmation"
 
response = requests.get(
    f"https://api.bahasha.app/v1/whatsapp/phone_numbers/{phone_number_id}/templates/{template_name}",
    headers={"Authorization": "Bearer bh_live_xxxxxxxxxxxx"},
)
 
print(response.json())

Response


{
  "id": "6643c2a1f4e3b12d5c9a0001",
  "name": "order_confirmation",
  "language": "en_US",
  "category": "UTILITY",
  "status": "APPROVED",
  "components": [
    {
      "type": "BODY",
      "text": "Hi {{customer_name}}, your order {{order_id}} is confirmed."
    }
  ],
  "expected_variables": {
    "header": [],
    "body": [
      { "param_name": "customer_name", "example": "John Doe" },
      { "param_name": "order_id", "example": "ORD-12345" }
    ],
    "buttons": []
  }
}

Returns 404 if the template name does not exist or is not accessible for the given phone number.

Understanding `expected_variables`

The expected_variables object tells you what to pass in the variables field when sending. There are three variable styles:

Style	`param_name` type	Example key in `variables`
No variables	—	Omit `variables` entirely
Named	String, e.g. `"customer_name"`	`variables.body.customer_name`
Positional	Number, e.g. `1`	`variables.body["1"]`

Authentication templates always have a single body variable with param_name: 1 — this is the OTP code.

See Passing template variables for full examples.

Templates

List templates for a phone number

cURL

JavaScript

Python

Response

Key fields

Get a specific template by name

cURL

JavaScript

Python

Response

Understanding expected_variables

Understanding `expected_variables`