Skip to main content
POST
/
whatsapp
/
templates
Submit a WhatsApp template for approval. Note: it is not possible to update existing templates via API. You can manually update templates by visiting the 360dialog page via https://wabamanagement.360dialog.io 
curl --request POST \
  --url https://1-some-client.some-server.healvi-chat/third-party/v1/whatsapp/templates \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "name": "<string>",
  "friendly_name": "<string>",
  "group": "<string>",
  "category": "AUTHENTICATION",
  "components": [
    {}
  ],
  "agent_id": 123
}
'
{
  "data": {
    "id": 123,
    "agent_ids": [
      123
    ],
    "group": "<string>",
    "template_id": "<string>",
    "namespace": "<string>",
    "name": "<string>",
    "friendly_name": "<string>",
    "language": "<string>",
    "category": "AUTHENTICATION",
    "status": "created",
    "components": [
      {}
    ]
  }
}

Authorizations

​
Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Body

application/json
​
name
string

Name of template. Must be lowercase, allowed characters are a-z, 0-9 and underscores.

​
friendly_name
string | null

Optional name for template without the technical naming rules of the regular name. Used for display.

​
group
string | null

Optional group for filtering later. Reserved group names are: system, restart

​
category
enum<string>

Category of template. Determines cost of sending message with this template.

Available options:
AUTHENTICATION,
MARKETING,
UTILITY
​
components
object[]

Parts of the template (header, body, footer, buttons) with their content. Placeholders like {{1}} can be used per part to make template dynamic. Format is defined by WhatsApp. See examples on https://docs.360dialog.com/partner/messaging/template-messages

​
agent_id
integer | null

Optional ID of WhatsApp agent to use for creating the template. Defaults to first available agent.

Response

200 - application/json

Success

​
data
object

Template submitted to WhatsApp for approval. Necessary to create business initiated conversations.