Message Templates
Last updated
Was this helpful?
Last updated
Was this helpful?
Message Templates are referred to as channel templates through the API
GET /workspaces/{workspaceId}/projects/{projectId}/channel-templates/{channelTemplateId} HTTP/1.1
Host:
Authorization: Bearer jwt
Accept: */*
{
"id": "123e4567-e89b-12d3-a456-426614174000",
"projectId": "123e4567-e89b-12d3-a456-426614174000",
"status": "draft",
"localeStatuses": {
"ANY_ADDITIONAL_PROPERTY": "draft"
},
"description": "text",
"defaultLocale": "en",
"assets": [
{
"key": "logoUrl",
"isDefault": true,
"valueString": "text"
}
],
"styles": [
{
"key": "text",
"valueString": "text",
"isDefault": true
}
],
"deployments": [
{
"key": "whatsappCategory",
"value": "text",
"locale": "text",
"platform": "text"
}
],
"variables": [
{
"key": "text",
"description": "text",
"type": "string",
"format": "none",
"sourceUrl": {
"fullyReplaced": true,
"value": "text"
},
"characterLimit": 1,
"examplesLocale": {
"ANY_ADDITIONAL_PROPERTY": {
"exampleValueStrings": [
"text"
],
"exampleValues": [
{
"sections": [
{
"id": "text",
"multipleSelection": true,
"title": "text",
"items": [
{
"id": "text",
"type": "reply-action",
"reference": "text",
"role": "text",
"hidden": true,
"replyAction": {
"text": "text",
"imageUrl": "text",
"payload": "text"
}
}
]
}
]
}
]
}
}
}
],
"genericContent": [
{
"locale": "en",
"type": "text",
"blocks": [
{
"id": "text",
"reference": "text",
"role": "text",
"hidden": true,
"type": "action",
"action": {
"type": "link",
"id": "text",
"reference": "text",
"role": "text",
"hidden": true,
"link": {
"text": "text",
"url": "https://example.com"
}
}
}
]
}
],
"platformContent": [
{
"locale": "en",
"type": "text",
"platform": "text",
"channelIds": [
"123e4567-e89b-12d3-a456-426614174000"
],
"channelGroupIds": [
"123e4567-e89b-12d3-a456-426614174000"
],
"blocks": [
{
"id": "text",
"reference": "text",
"role": "text",
"hidden": true,
"type": "action",
"action": {
"type": "link",
"id": "text",
"reference": "text",
"role": "text",
"hidden": true,
"link": {
"text": "text",
"url": "https://example.com"
}
}
}
],
"approvals": [
{
"approvalReference": "123e4567-e89b-12d3-a456-426614174000",
"platformReference": "text",
"platformAccountIdentifier": "text",
"reasonCode": "whatsapp_scam",
"reasonDescription": "text",
"status": "pending",
"platformStatus": "whatsapp_approved",
"channelIds": [
"123e4567-e89b-12d3-a456-426614174000"
],
"channelGroupId": "123e4567-e89b-12d3-a456-426614174000",
"platform": "whatsapp"
}
]
}
],
"supportedPlatforms": [
"all"
],
"createdAt": "2025-04-18T23:54:13.209Z",
"updatedAt": "2025-04-18T23:54:13.209Z",
"isCloneable": true,
"editorId": "123e4567-e89b-12d3-a456-426614174000",
"editorType": "text",
"publisherId": "123e4567-e89b-12d3-a456-426614174000",
"publisherType": "text",
"shortLinks": {},
"clonedFrom": "123e4567-e89b-12d3-a456-426614174000",
"reviewInfo": {
"approvalFlowId": "123e4567-e89b-12d3-a456-426614174000",
"approvalRunId": "123e4567-e89b-12d3-a456-426614174000",
"status": "pending",
"currentStep": 1
}
}
DELETE /workspaces/{workspaceId}/projects/{projectId}/channel-templates/{channelTemplateId} HTTP/1.1
Host:
Authorization: Bearer jwt
Accept: */*
No content
PUT /workspaces/{workspaceId}/projects/{projectId}/channel-templates/{channelTemplateId}/activate HTTP/1.1
Host:
Authorization: Bearer jwt
Accept: */*
No content
PUT /workspaces/{workspaceId}/projects/{projectId}/channel-templates/{channelTemplateId}/deactivate HTTP/1.1
Host:
Authorization: Bearer jwt
Accept: */*
No content
Limits the project of results to return
10
Pagination token that keeps of track of the current position in the list
Order in which to retrieve the results
false
GET /workspaces/{workspaceId}/projects/{projectId}/channel-templates HTTP/1.1
Host:
Authorization: Bearer jwt
Accept: */*
{
"results": [
{
"id": "123e4567-e89b-12d3-a456-426614174000",
"projectId": "123e4567-e89b-12d3-a456-426614174000",
"status": "draft",
"localeStatuses": {
"ANY_ADDITIONAL_PROPERTY": "draft"
},
"description": "text",
"defaultLocale": "en",
"assets": [
{
"key": "logoUrl",
"isDefault": true,
"valueString": "text"
}
],
"styles": [
{
"key": "text",
"valueString": "text",
"isDefault": true
}
],
"deployments": [
{
"key": "whatsappCategory",
"value": "text",
"locale": "text",
"platform": "text"
}
],
"variables": [
{
"key": "text",
"description": "text",
"type": "string",
"format": "none",
"sourceUrl": {
"fullyReplaced": true,
"value": "text"
},
"characterLimit": 1,
"examplesLocale": {
"ANY_ADDITIONAL_PROPERTY": {
"exampleValueStrings": [
"text"
],
"exampleValues": [
{
"sections": [
{
"id": "text",
"multipleSelection": true,
"title": "text",
"items": [
{
"id": "text",
"type": "reply-action",
"reference": "text",
"role": "text",
"hidden": true,
"replyAction": {
"text": "text",
"imageUrl": "text",
"payload": "text"
}
}
]
}
]
}
]
}
}
}
],
"genericContent": [
{
"locale": "en",
"type": "text",
"blocks": [
{
"id": "text",
"reference": "text",
"role": "text",
"hidden": true,
"type": "action",
"action": {
"type": "link",
"id": "text",
"reference": "text",
"role": "text",
"hidden": true,
"link": {
"text": "text",
"url": "https://example.com"
}
}
}
]
}
],
"platformContent": [
{
"locale": "en",
"type": "text",
"platform": "text",
"channelIds": [
"123e4567-e89b-12d3-a456-426614174000"
],
"channelGroupIds": [
"123e4567-e89b-12d3-a456-426614174000"
],
"blocks": [
{
"id": "text",
"reference": "text",
"role": "text",
"hidden": true,
"type": "action",
"action": {
"type": "link",
"id": "text",
"reference": "text",
"role": "text",
"hidden": true,
"link": {
"text": "text",
"url": "https://example.com"
}
}
}
],
"approvals": [
{
"approvalReference": "123e4567-e89b-12d3-a456-426614174000",
"platformReference": "text",
"platformAccountIdentifier": "text",
"reasonCode": "whatsapp_scam",
"reasonDescription": "text",
"status": "pending",
"platformStatus": "whatsapp_approved",
"channelIds": [
"123e4567-e89b-12d3-a456-426614174000"
],
"channelGroupId": "123e4567-e89b-12d3-a456-426614174000",
"platform": "whatsapp"
}
]
}
],
"supportedPlatforms": [
"all"
],
"createdAt": "2025-04-18T23:54:13.209Z",
"updatedAt": "2025-04-18T23:54:13.209Z",
"isCloneable": true,
"editorId": "123e4567-e89b-12d3-a456-426614174000",
"editorType": "text",
"publisherId": "123e4567-e89b-12d3-a456-426614174000",
"publisherType": "text",
"shortLinks": {},
"clonedFrom": "123e4567-e89b-12d3-a456-426614174000",
"reviewInfo": {
"approvalFlowId": "123e4567-e89b-12d3-a456-426614174000",
"approvalRunId": "123e4567-e89b-12d3-a456-426614174000",
"status": "pending",
"currentStep": 1
}
}
],
"nextPageToken": "text"
}
POST /workspaces/{workspaceId}/projects/{projectId}/channel-templates HTTP/1.1
Host:
Authorization: Bearer jwt
Content-Type: application/json
Accept: */*
Content-Length: 1881
{
"description": "text",
"defaultLocale": "text",
"assets": [
{
"key": "logoUrl",
"isDefault": true,
"valueString": "text"
}
],
"styles": [
{
"key": "text",
"valueString": "text",
"isDefault": true
}
],
"variables": [
{
"key": "text",
"description": "text",
"type": "string",
"format": "none",
"sourceUrl": {
"fullyReplaced": true,
"value": "text"
},
"characterLimit": 1,
"examplesLocale": {
"ANY_ADDITIONAL_PROPERTY": {
"exampleValueStrings": [
"text"
],
"exampleValues": [
{
"sections": [
{
"id": "text",
"multipleSelection": true,
"title": "text",
"items": [
{
"id": "text",
"type": "reply-action",
"reference": "text",
"role": "text",
"hidden": true,
"replyAction": {
"text": "text",
"imageUrl": "text",
"payload": "text"
}
}
]
}
]
}
]
}
}
}
],
"deployments": [
{
"key": "whatsappCategory",
"value": "text",
"locale": "text",
"platform": "text"
}
],
"genericContent": [
{
"locale": "en",
"type": "text",
"blocks": [
{
"id": "text",
"reference": "text",
"role": "text",
"hidden": true,
"type": "action",
"action": {
"type": "link",
"id": "text",
"reference": "text",
"role": "text",
"hidden": true,
"link": {
"text": "text",
"url": "https://example.com"
}
}
}
]
}
],
"platformContent": [
{
"locale": "en",
"type": "text",
"platform": "text",
"channelIds": [
"123e4567-e89b-12d3-a456-426614174000"
],
"channelGroupIds": [
"123e4567-e89b-12d3-a456-426614174000"
],
"blocks": [
{
"id": "text",
"reference": "text",
"role": "text",
"hidden": true,
"type": "action",
"action": {
"type": "link",
"id": "text",
"reference": "text",
"role": "text",
"hidden": true,
"link": {
"text": "text",
"url": "https://example.com"
}
}
}
],
"approvals": [
{
"approvalReference": "123e4567-e89b-12d3-a456-426614174000",
"platformReference": "text",
"platformAccountIdentifier": "text",
"reasonCode": "whatsapp_scam",
"reasonDescription": "text",
"status": "pending",
"platformStatus": "whatsapp_approved",
"channelIds": [
"123e4567-e89b-12d3-a456-426614174000"
],
"channelGroupId": "123e4567-e89b-12d3-a456-426614174000",
"platform": "whatsapp"
}
]
}
],
"supportedPlatforms": [
"all"
],
"shortLinks": {},
"ANY_ADDITIONAL_PROPERTY": "anything"
}
{
"id": "123e4567-e89b-12d3-a456-426614174000",
"projectId": "123e4567-e89b-12d3-a456-426614174000",
"status": "draft",
"localeStatuses": {
"ANY_ADDITIONAL_PROPERTY": "draft"
},
"description": "text",
"defaultLocale": "en",
"assets": [
{
"key": "logoUrl",
"isDefault": true,
"valueString": "text"
}
],
"styles": [
{
"key": "text",
"valueString": "text",
"isDefault": true
}
],
"deployments": [
{
"key": "whatsappCategory",
"value": "text",
"locale": "text",
"platform": "text"
}
],
"variables": [
{
"key": "text",
"description": "text",
"type": "string",
"format": "none",
"sourceUrl": {
"fullyReplaced": true,
"value": "text"
},
"characterLimit": 1,
"examplesLocale": {
"ANY_ADDITIONAL_PROPERTY": {
"exampleValueStrings": [
"text"
],
"exampleValues": [
{
"sections": [
{
"id": "text",
"multipleSelection": true,
"title": "text",
"items": [
{
"id": "text",
"type": "reply-action",
"reference": "text",
"role": "text",
"hidden": true,
"replyAction": {
"text": "text",
"imageUrl": "text",
"payload": "text"
}
}
]
}
]
}
]
}
}
}
],
"genericContent": [
{
"locale": "en",
"type": "text",
"blocks": [
{
"id": "text",
"reference": "text",
"role": "text",
"hidden": true,
"type": "action",
"action": {
"type": "link",
"id": "text",
"reference": "text",
"role": "text",
"hidden": true,
"link": {
"text": "text",
"url": "https://example.com"
}
}
}
]
}
],
"platformContent": [
{
"locale": "en",
"type": "text",
"platform": "text",
"channelIds": [
"123e4567-e89b-12d3-a456-426614174000"
],
"channelGroupIds": [
"123e4567-e89b-12d3-a456-426614174000"
],
"blocks": [
{
"id": "text",
"reference": "text",
"role": "text",
"hidden": true,
"type": "action",
"action": {
"type": "link",
"id": "text",
"reference": "text",
"role": "text",
"hidden": true,
"link": {
"text": "text",
"url": "https://example.com"
}
}
}
],
"approvals": [
{
"approvalReference": "123e4567-e89b-12d3-a456-426614174000",
"platformReference": "text",
"platformAccountIdentifier": "text",
"reasonCode": "whatsapp_scam",
"reasonDescription": "text",
"status": "pending",
"platformStatus": "whatsapp_approved",
"channelIds": [
"123e4567-e89b-12d3-a456-426614174000"
],
"channelGroupId": "123e4567-e89b-12d3-a456-426614174000",
"platform": "whatsapp"
}
]
}
],
"supportedPlatforms": [
"all"
],
"createdAt": "2025-04-18T23:54:13.209Z",
"updatedAt": "2025-04-18T23:54:13.209Z",
"isCloneable": true,
"editorId": "123e4567-e89b-12d3-a456-426614174000",
"editorType": "text",
"publisherId": "123e4567-e89b-12d3-a456-426614174000",
"publisherType": "text",
"shortLinks": {},
"clonedFrom": "123e4567-e89b-12d3-a456-426614174000",
"reviewInfo": {
"approvalFlowId": "123e4567-e89b-12d3-a456-426614174000",
"approvalRunId": "123e4567-e89b-12d3-a456-426614174000",
"status": "pending",
"currentStep": 1
}
}
If true and template is already published, a new template will be created with the new parameters and activated.
PATCH /workspaces/{workspaceId}/projects/{projectId}/channel-templates/{channelTemplateId} HTTP/1.1
Host:
Authorization: Bearer jwt
Content-Type: application/json
Accept: */*
Content-Length: 1902
{
"defaultLocale": "text",
"description": "text",
"assets": [
{
"key": "logoUrl",
"isDefault": true,
"valueString": "text"
}
],
"styles": [
{
"key": "text",
"valueString": "text",
"isDefault": true
}
],
"variables": [
{
"key": "text",
"description": "text",
"type": "string",
"format": "none",
"sourceUrl": {
"fullyReplaced": true,
"value": "text"
},
"characterLimit": 1,
"examplesLocale": {
"ANY_ADDITIONAL_PROPERTY": {
"exampleValueStrings": [
"text"
],
"exampleValues": [
{
"sections": [
{
"id": "text",
"multipleSelection": true,
"title": "text",
"items": [
{
"id": "text",
"type": "reply-action",
"reference": "text",
"role": "text",
"hidden": true,
"replyAction": {
"text": "text",
"imageUrl": "text",
"payload": "text"
}
}
]
}
]
}
]
}
}
}
],
"deployments": [
{
"key": "whatsappCategory",
"value": "text",
"locale": "text",
"platform": "text"
}
],
"genericContent": [
{
"locale": "en",
"type": "text",
"blocks": [
{
"id": "text",
"reference": "text",
"role": "text",
"hidden": true,
"type": "action",
"action": {
"type": "link",
"id": "text",
"reference": "text",
"role": "text",
"hidden": true,
"link": {
"text": "text",
"url": "https://example.com"
}
}
}
]
}
],
"platformContent": [
{
"locale": "en",
"type": "text",
"platform": "text",
"channelIds": [
"123e4567-e89b-12d3-a456-426614174000"
],
"channelGroupIds": [
"123e4567-e89b-12d3-a456-426614174000"
],
"blocks": [
{
"id": "text",
"reference": "text",
"role": "text",
"hidden": true,
"type": "action",
"action": {
"type": "link",
"id": "text",
"reference": "text",
"role": "text",
"hidden": true,
"link": {
"text": "text",
"url": "https://example.com"
}
}
}
],
"approvals": [
{
"approvalReference": "123e4567-e89b-12d3-a456-426614174000",
"platformReference": "text",
"platformAccountIdentifier": "text",
"reasonCode": "whatsapp_scam",
"reasonDescription": "text",
"status": "pending",
"platformStatus": "whatsapp_approved",
"channelIds": [
"123e4567-e89b-12d3-a456-426614174000"
],
"channelGroupId": "123e4567-e89b-12d3-a456-426614174000",
"platform": "whatsapp"
}
]
}
],
"supportedPlatforms": [
"all"
],
"forceUpdate": true,
"status": "active",
"ANY_ADDITIONAL_PROPERTY": "anything"
}
{
"id": "123e4567-e89b-12d3-a456-426614174000",
"projectId": "123e4567-e89b-12d3-a456-426614174000",
"status": "draft",
"localeStatuses": {
"ANY_ADDITIONAL_PROPERTY": "draft"
},
"description": "text",
"defaultLocale": "en",
"assets": [
{
"key": "logoUrl",
"isDefault": true,
"valueString": "text"
}
],
"styles": [
{
"key": "text",
"valueString": "text",
"isDefault": true
}
],
"deployments": [
{
"key": "whatsappCategory",
"value": "text",
"locale": "text",
"platform": "text"
}
],
"variables": [
{
"key": "text",
"description": "text",
"type": "string",
"format": "none",
"sourceUrl": {
"fullyReplaced": true,
"value": "text"
},
"characterLimit": 1,
"examplesLocale": {
"ANY_ADDITIONAL_PROPERTY": {
"exampleValueStrings": [
"text"
],
"exampleValues": [
{
"sections": [
{
"id": "text",
"multipleSelection": true,
"title": "text",
"items": [
{
"id": "text",
"type": "reply-action",
"reference": "text",
"role": "text",
"hidden": true,
"replyAction": {
"text": "text",
"imageUrl": "text",
"payload": "text"
}
}
]
}
]
}
]
}
}
}
],
"genericContent": [
{
"locale": "en",
"type": "text",
"blocks": [
{
"id": "text",
"reference": "text",
"role": "text",
"hidden": true,
"type": "action",
"action": {
"type": "link",
"id": "text",
"reference": "text",
"role": "text",
"hidden": true,
"link": {
"text": "text",
"url": "https://example.com"
}
}
}
]
}
],
"platformContent": [
{
"locale": "en",
"type": "text",
"platform": "text",
"channelIds": [
"123e4567-e89b-12d3-a456-426614174000"
],
"channelGroupIds": [
"123e4567-e89b-12d3-a456-426614174000"
],
"blocks": [
{
"id": "text",
"reference": "text",
"role": "text",
"hidden": true,
"type": "action",
"action": {
"type": "link",
"id": "text",
"reference": "text",
"role": "text",
"hidden": true,
"link": {
"text": "text",
"url": "https://example.com"
}
}
}
],
"approvals": [
{
"approvalReference": "123e4567-e89b-12d3-a456-426614174000",
"platformReference": "text",
"platformAccountIdentifier": "text",
"reasonCode": "whatsapp_scam",
"reasonDescription": "text",
"status": "pending",
"platformStatus": "whatsapp_approved",
"channelIds": [
"123e4567-e89b-12d3-a456-426614174000"
],
"channelGroupId": "123e4567-e89b-12d3-a456-426614174000",
"platform": "whatsapp"
}
]
}
],
"supportedPlatforms": [
"all"
],
"createdAt": "2025-04-18T23:54:13.209Z",
"updatedAt": "2025-04-18T23:54:13.209Z",
"isCloneable": true,
"editorId": "123e4567-e89b-12d3-a456-426614174000",
"editorType": "text",
"publisherId": "123e4567-e89b-12d3-a456-426614174000",
"publisherType": "text",
"shortLinks": {},
"clonedFrom": "123e4567-e89b-12d3-a456-426614174000",
"reviewInfo": {
"approvalFlowId": "123e4567-e89b-12d3-a456-426614174000",
"approvalRunId": "123e4567-e89b-12d3-a456-426614174000",
"status": "pending",
"currentStep": 1
}
}
POST /workspaces/{workspaceId}/projects/channel-templates/create-preview HTTP/1.1
Host:
Authorization: Bearer jwt
Content-Type: application/json
Accept: */*
Content-Length: 499
{
"platform": "text",
"blocks": [
{
"id": "text",
"reference": "text",
"role": "text",
"hidden": true,
"type": "action",
"action": {
"type": "link",
"id": "text",
"reference": "text",
"role": "text",
"hidden": true,
"link": {
"text": "text",
"url": "https://example.com"
}
}
}
],
"styles": [
{
"key": "text",
"valueString": "text",
"isDefault": true
}
],
"variables": {
"ANY_ADDITIONAL_PROPERTY": "text"
},
"parameters": [
{
"type": "string",
"sourceUrl": {
"fullyReplaced": true,
"value": "text"
},
"key": "text",
"value": "text"
}
],
"shortLinks": {},
"contactId": "text"
}
{
"validationErrors": {
"ANY_ADDITIONAL_PROPERTY": [
"text"
]
},
"type": "body",
"body": {
"type": "text",
"text": {
"text": "text",
"attachments": [
{
"mediaUrl": "https://example.com",
"filename": "text",
"inline": true
}
],
"actions": [
{
"type": "link",
"link": {
"text": "text",
"url": "text"
}
}
],
"metadata": {
"subject": "text",
"headers": {
"ANY_ADDITIONAL_PROPERTY": "text"
},
"whatsapp": {
"previewUrl": true
},
"line": {
"emoji": {
"items": [
{
"index": 1,
"productId": "text",
"emojiId": "text",
"length": 1
}
]
}
},
"telegram": {
"parseMode": "Markdown"
}
}
}
},
"blocks": [
{
"id": "text",
"reference": "text",
"role": "text",
"hidden": true,
"type": "action",
"action": {
"type": "link",
"id": "text",
"reference": "text",
"role": "text",
"hidden": true,
"link": {
"text": "text",
"url": "https://example.com"
}
}
}
],
"styles": [
{
"key": "text",
"valueString": "text",
"isDefault": true
}
]
}