Sent LogoSent API Docs

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.

POST
/v2/templates
x-sender-id<token>

In: header

Header Parameters

x-sender-idstring
Formatguid
x-api-keystring
category?string | null
language?string | null
definition?SentDmServicesContractsPOCOsTemplateDefinition
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