For AI agents: a documentation index is available at the root level at /llms.txt and /llms-full.txt. Append /llms.txt to any URL for a page-level index, or .md for the markdown version of any page.
Help CenterAPI KeysStatusSign In
GuidesAPI ReferenceChangelog
GuidesAPI ReferenceChangelog
  • Introduction
    • Getting started
  • Email API
  • Transactional SMS
  • Transactional WhatsApp
  • Marketing Campaigns
      • GETGet a WhatsApp campaign
      • DELDelete a WhatsApp campaign
      • PUTUpdate a WhatsApp campaign
      • GETReturn all your created WhatsApp templates
      • POSTCreate and Send a WhatsApp campaign
      • GETReturn all your created WhatsApp campaigns
      • GETGet your WhatsApp API account information
  • Contact Management
  • Events
    • GETGet events
    • POSTCreate an event
    • POSTCreate events in batch
  • Object Management
  • Accounts and Settings
  • Sales CRM
  • Conversations
  • Ecommerce
  • Loyalty
LogoLogo
Help CenterAPI KeysStatusSign In
Marketing CampaignsWhatsApp Campaigns

Return all your created WhatsApp templates

GET
https://api.brevo.com/v3/whatsappCampaigns/template-list
GET
/v3/whatsappCampaigns/template-list
1import { BrevoClient } from "@getbrevo/brevo";
2
3async function main() {
4 const client = new BrevoClient({
5 apiKey: "YOUR_API_KEY_HERE",
6 });
7 await client.whatsAppCampaigns.getWhatsAppTemplates({});
8}
9main();
1{
2 "count": 2,
3 "templates": [
4 {
5 "category": "MARKETING",
6 "createdAt": "2017-05-01T12:30:00Z",
7 "id": 235,
8 "language": "en",
9 "modifiedAt": "2017-05-01T12:30:00Z",
10 "name": "campaign_22",
11 "status": "approved",
12 "type": "whatsapp",
13 "errorReason": "NONE"
14 },
15 {
16 "category": "MARKETING",
17 "createdAt": "2017-0",
18 "id": 124,
19 "language": "",
20 "modifiedAt": "2017-05-01T12:30:00Z",
21 "name": "test-template",
22 "status": "draft",
23 "type": "whatsapp",
24 "errorReason": "NONE"
25 }
26 ]
27}

Retrieve a paginated list of all your WhatsApp templates with their status, category, language, and metadata. Results can be filtered by creation date range and optionally by source (Automation or Conversations), with a default limit of 50 and maximum of 100 per page. The sort order defaults to descending by modification date.

Was this page helpful?
Previous

Create and Send a WhatsApp campaign

Next
Built with

Authentication

api-keystring

The API key should be passed in the request headers as api-key for authentication.

Query parameters

startDatestringOptional

Mandatory if endDate is used. Starting (urlencoded) UTC date-time (YYYY-MM-DDTHH:mm:ss.SSSZ) to filter the templates created. Prefer to pass your timezone in date-time format for accurate result

endDatestringOptional

Mandatory if startDate is used. Ending (urlencoded) UTC date-time (YYYY-MM-DDTHH:mm:ss.SSSZ) to filter the templates created. Prefer to pass your timezone in date-time format for accurate result

limitlongOptional0-100Defaults to 50
Number of documents per page
offsetlongOptionalDefaults to 0
Index of the first document in the page
sortenumOptionalDefaults to desc

Sort the results in the ascending/descending order of record modification. Default order is descending if sort is not passed

Allowed values:
sourceenumOptional
source of the template
Allowed values:

Response

WhatsApp templates informations
countlong
Number of whatsApp templates retrieved
templateslist of objects

Errors

400
Bad Request Error