WhatsApp · WhatsApp
Fetches a template by id.
GET
https://api.pozy.ai/v1/whatsapp/templates/id/{templateId}getWhatsAppTemplateById
Guide: Message templates
Request
Send your API key as Authorization: Bearer pz_live_.... Read-only keys can call it. Keys with the accounts resource group disabled get 403 resource_group_disabled. Authentication
Path parameters
| Name | Type | Notes |
|---|---|---|
templateIdrequired | string |
Query parameters
| Name | Type | Notes |
|---|---|---|
accountIdrequired | string |
Example
curl -X GET "https://api.pozy.ai/v1/whatsapp/templates/id/68fc85b3d7dcabf758aa29d2?accountId=696e0b682d0a31188e7a2ba9" \
-H "Authorization: Bearer $POZY_API_KEY"const res = await fetch("https://api.pozy.ai/v1/whatsapp/templates/id/68fc85b3d7dcabf758aa29d2?accountId=696e0b682d0a31188e7a2ba9", {
headers: { Authorization: `Bearer ${process.env.POZY_API_KEY}` },
});
const data = await res.json();
if (!res.ok) throw new Error(data?.error ?? `Request failed with status ${res.status}`);
console.log(data);import os
import requests
resp = requests.get(
"https://api.pozy.ai/v1/whatsapp/templates/id/68fc85b3d7dcabf758aa29d2",
headers={"Authorization": f"Bearer {os.environ['POZY_API_KEY']}"},
params={
"accountId": "696e0b682d0a31188e7a2ba9",
},
timeout=30,
)
resp.raise_for_status()
print(resp.json())Response
200 on success
successbooleantemplateobject9 child fields
idstringnamestringstatusstringcategorystringlanguagestringcomponentsarray of objectmessage_send_ttl_secondsintegerrejected_reasonstringquality_scoreobject
200 response
{
"success": true,
"template": {
"id": "6bfebd43ddc270f6d2c56fc5",
"name": "Acme",
"status": "active",
"category": "string",
"language": "en",
"components": [
{}
],
"message_send_ttl_seconds": 1,
"rejected_reason": "string",
"quality_score": {}
}
}Errors
Errors use one shape: { error, type, code, param?, details? }. The ones you are most likely to see here:
| 400 | invalid_request_error | A parameter or body field is missing or invalid. param names it. |
| 401 | authentication_error | The API key is missing, revoked or expired. |
| 403 | permission_error | The key is scoped to other profiles or has this resource group disabled. |
| 404 | not_found | Nothing with that id exists in your workspace. |
| 429 | rate_limit_error | Too many requests this minute. Wait for Retry-After seconds. |
Every code is listed in Errors.
More in WhatsApp
POSTRegister a connected WhatsApp number on the Cloud APIPOSTRequest a Meta re-verification code for a BYO WhatsApp numberPOSTVerify the Meta re-verification code for a BYO WhatsApp numberGETDownload WhatsApp mediaGETList templatesPOSTCreate templateGETGet templatePATCHUpdate templateDELDelete templatePATCHUpdate template by idDELDelete template by idGETList the catalogs linked to a WhatsApp numberPOSTLink a catalog to a WhatsApp numberDELUnlink a catalog from a WhatsApp numberGETGet a number's commerce settingsPUTUpdate a number's commerce settingsGETGet ice breakers and commandsPOSTSet ice breakers and commandsDELClear ice breakers and commandsGETGet business profilePOSTUpdate business profilePOSTUpload profile pictureGETGet display name statusPOSTRequest display name changeGETGet business usernamePOSTSet business usernameDELDelete business usernameGETGet username suggestionsGETCheck if a user is blockedGETList blocked usersPOSTBlock usersDELUnblock usersGETList account notificationsGETGet CTWA conversions datasetPOSTProvision CTWA datasetGETList active groupsPOSTCreate groupGETGet group infoPOSTUpdate group settingsDELDelete groupPOSTAdd participantsDELRemove participantsPOSTCreate invite linkGETList join requestsPOSTApprove join requestsDELReject join requestsGETList conversion eventsPOSTSend WhatsApp conversion event