List WhatsApp templates

GET/api/v1/whatsapp/templates

Lists the message templates of an official WhatsApp channel (360dialog / Meta), with each template's status and the variables to fill when sending it with Send message → whatsappTemplate.

Only APPROVED templates can be sent.
variables lists the body placeholders in order: "1", "2" for positional placeholders, or names such as first_name for named ones. Send a value for each.
QR-linked WhatsApp numbers have no templates.

Errors

400: the channel isn't an official WhatsApp channel, has no API key yet (reconnect it), or 360dialog couldn't be reached.
404: the channel wasn't found.

Request

Authorization

Bearer Token

Provide your API token in the Authorization header. See Authentication to issue one.

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

Query Params

channelIdstringrequired
ID of the official WhatsApp channel (uuid). Find it with the Channel endpoints.

Responses

200

statusintegerrequired
bodyobjectrequired
Child attributes
- requestIdstringrequired
- dataarray[object]required
  Child attributes
  namestringoptional
  languagestringoptional
  categorystringoptional
  statusstringoptional
  componentsarray[object]optional
  Child attributes
  typestringoptional
  textstringoptional
  variablesarray[string]optional

Request

curl -X GET "https://apigw.klinkcx.com/api/v1/whatsapp/templates?channelId=%7BchannelId%7D" \
  -H "Authorization: Bearer {token}"

Response

{
  "status": 200,
  "body": {
    "requestId": "8a1f2c3d-5e6f-4a7b-9c8d-0e1f2a3b4c5d",
    "data": [
      {
        "name": "welcomemessage",
        "language": "en",
        "category": "MARKETING",
        "status": "APPROVED",
        "components": [
          {
            "type": "BODY",
            "text": "Hey {{first_name}} 👋\n\nThanks for signing up for klink.cloud!"
          }
        ],
        "variables": [
          "first_name"
        ]
      }
    ]
  }
}