Legacy API Notice: This documentation covers the Legacy Sent API (v2). While this API remains fully supported, we recommend new integrations use the latest Sent API v3 for enhanced features, improved performance, and long-term support.

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

id*string
Formatuuid

Response Body

application/json

curl -X GET "https://api.sent.dm/v2/templates/7ba7b820-9dad-11d1-80b4-00c04fd430c8"
{
  "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",
            "regex": null,
            "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",
              "regex": null,
              "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",
    "authenticationConfig": null
  },
  "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

Get all templates for authenticated customer with enhanced metadata and filtering 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 with enhanced metadata and optional submission for review 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.