Create a new template with enhanced metadata and optional submission for review
Creates a new message template for the authenticated customer with comprehensive template definitions including headers, body, footer, and interactive buttons. Supports automatic metadata generation using AI (display name, language, category). Optionally submits the template for WhatsApp review. The customer ID is extracted from the authentication token.
x-sender-id<token>
In: header
Header Parameters
x-sender-idstring
Format
guidx-api-keystring
category?string | null
language?string | null
definition?SentDmServicesCommonContractsPOCOsTemplateDefinition
submitForReview?boolean
Response Body
curl -X POST "https://api.sent.dm/v2/templates" \ -H "x-sender-id: string" \ -H "x-api-key: string" \ -H "Content-Type: application/json" \ -d '{ "category": "MARKETING", "language": "en_US", "definition": { "header": { "type": "text", "template": "Welcome to {{1:variable}}!", "variables": [ { "id": 1, "name": "companyName", "type": "variable", "props": { "variableType": "text", "sample": "SentDM", "url": null, "shortUrl": null, "alt": null, "mediaType": null } } ] }, "body": { "multiChannel": { "type": null, "template": "Hello {{1:variable}}, thank you for joining our service. We\'re excited to help you with your messaging needs!", "variables": [ { "id": 1, "name": "customerName", "type": "variable", "props": { "variableType": "text", "sample": "John Doe", "url": null, "shortUrl": null, "alt": null, "mediaType": null } } ] }, "sms": null, "whatsapp": null }, "footer": { "type": "text", "template": "Best regards, The SentDM Team", "variables": null }, "buttons": null, "definitionVersion": "1.0" }, "submitForReview": false }'{
"id": "string",
"displayName": "string",
"category": "string",
"language": "string",
"definition": {
"header": {
"type": "string",
"template": "string",
"variables": [
{
"id": 0,
"name": "string",
"type": "string",
"props": {
"variableType": "string",
"sample": "string",
"url": "string",
"shortUrl": "string",
"alt": "string",
"mediaType": "string"
}
}
]
},
"body": {
"multiChannel": {
"type": "string",
"template": "string",
"variables": [
{
"id": 0,
"name": "string",
"type": "string",
"props": {
"variableType": "string",
"sample": "string",
"url": "string",
"shortUrl": "string",
"alt": "string",
"mediaType": "string"
}
}
]
},
"sms": {
"type": "string",
"template": "string",
"variables": [
{
"id": 0,
"name": "string",
"type": "string",
"props": {
"variableType": "string",
"sample": "string",
"url": "string",
"shortUrl": "string",
"alt": "string",
"mediaType": "string"
}
}
]
},
"whatsapp": {
"type": "string",
"template": "string",
"variables": [
{
"id": 0,
"name": "string",
"type": "string",
"props": {
"variableType": "string",
"sample": "string",
"url": "string",
"shortUrl": "string",
"alt": "string",
"mediaType": "string"
}
}
]
}
},
"footer": {
"type": "string",
"template": "string",
"variables": [
{
"id": 0,
"name": "string",
"type": "string",
"props": {
"variableType": "string",
"sample": "string",
"url": "string",
"shortUrl": "string",
"alt": "string",
"mediaType": "string"
}
}
]
},
"buttons": [
{
"id": 0,
"type": "string",
"props": {
"text": "string",
"quickReplyType": "string",
"urlType": "string",
"url": "string",
"activeFor": 0,
"countryCode": "string",
"phoneNumber": "string",
"offerCode": "string"
}
}
],
"definitionVersion": "string"
},
"status": "string",
"isPublished": true,
"whatsappTemplateId": "string",
"whatsappTemplateName": "string",
"createdAt": "2019-08-24T14:15:22Z",
"updatedAt": "2019-08-24T14:15:22Z"
}Empty
Empty