Get template by ID with enhanced metadata

Retrieves a specific message template by its unique identifier for the authenticated customer with comprehensive template definitions including headers, body, footer, and interactive buttons. The customer ID is extracted from the authentication token.

GET
/v2/templates/{id}

Path Parameters

idstring
Formatguid

Header Parameters

x-sender-idstring
Formatguid
x-api-keystring

Response Body

application/json

curl -X GET "https://api.sent.dm/v2/templates/string" \  -H "x-sender-id: string" \  -H "x-api-key: string"
{
  "id": "7ba7b820-9dad-11d1-80b4-00c04fd430c8",
  "displayName": "Welcome Message Template",
  "category": "UTILITY",
  "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"
  },
  "status": "APPROVED",
  "isPublished": true,
  "whatsappTemplateId": "123456789",
  "whatsappTemplateName": "welcome_message_v1",
  "createdAt": "2024-01-15T10:30:00+00:00",
  "updatedAt": "2024-01-16T14:22:00+00:00"
}
Empty
Empty

List all templates GET

Retrieves all message templates available for the authenticated customer with comprehensive template definitions including headers, body, footer, and interactive buttons. Supports advanced filtering by search term, status, and category, plus pagination. The customer ID is extracted from the authentication token.

Create a new template POST

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.