Get template by ID

Retrieves a specific template by its ID. Returns template details including name, category, language, status, and definition.

GET
/v3/templates/{id}

Response Body

application/json

application/json

application/json

application/json

curl -X GET "https://api.sent.dm/v3/templates/7ba7b820-9dad-11d1-80b4-00c04fd430c8"
{
  "success": true,
  "data": {
    "id": "7ba7b820-9dad-11d1-80b4-00c04fd430c8",
    "name": "Welcome Message",
    "category": "MARKETING",
    "language": "en_US",
    "status": "APPROVED",
    "channels": [
      "sms",
      "whatsapp"
    ],
    "variables": [
      "name",
      "company"
    ],
    "created_at": "2026-03-01T15:21:52.0607307+00:00",
    "updated_at": "2026-03-16T15:21:52.0607324+00:00",
    "is_published": true
  },
  "error": null,
  "meta": {
    "request_id": "req_7X9zKp2jDw",
    "timestamp": "2026-03-31T15:21:52.0607328+00:00",
    "version": "v3"
  }
}
{
  "success": false,
  "data": null,
  "error": {
    "code": "VALIDATION_001",
    "message": "Invalid template ID format.",
    "details": null,
    "doc_url": "https://docs.sent.dm/docs/reference/api/error-catalog"
  },
  "meta": {
    "request_id": "req_7X9zKp2jDw",
    "timestamp": "2026-03-31T15:21:52.0607345+00:00",
    "version": "v3"
  }
}
Empty
Empty
{
  "success": false,
  "data": null,
  "error": {
    "code": "RESOURCE_002",
    "message": "Template not found",
    "details": null,
    "doc_url": "https://docs.sent.dm/docs/reference/api/error-catalog"
  },
  "meta": {
    "request_id": "req_7X9zKp2jDw",
    "timestamp": "2026-03-31T15:21:52.060735+00:00",
    "version": "v3"
  }
}
{
  "success": false,
  "data": null,
  "error": {
    "code": "INTERNAL_001",
    "message": "An unexpected error occurred while retrieving the template",
    "details": null,
    "doc_url": "https://docs.sent.dm/docs/reference/api/error-catalog"
  },
  "meta": {
    "request_id": "req_7X9zKp2jDw",
    "timestamp": "2026-03-31T15:21:52.0607355+00:00",
    "version": "v3"
  }
}

Get templates list GET

Retrieves a paginated list of message templates for the authenticated customer. Supports filtering by status, category, and search term.

Create a new template POST

Creates a new message template with header, body, footer, and buttons. The template can be submitted for review immediately or saved as draft for later submission.