Get template by ID
Retrieves a specific template by its ID. Returns template details including name, category, language, status, and definition.
Response Body
application/json
application/json
application/json
application/json
curl -X GET "https://example.com/v3/templates/7ba7b820-9dad-11d1-80b4-00c04fd430c8"{
"success": true,
"data": {
"id": "7ba7b820-9dad-11d1-80b4-00c04fd430c8",
"customer_id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
"name": "Welcome Message",
"category": "MARKETING",
"auto_reply_action": null,
"language": "en_US",
"status": "APPROVED",
"channels": [
"sms",
"whatsapp",
"rcs"
],
"variables": [
"name",
"company"
],
"created_at": "2026-08-18T16:01:14.6852639+00:00",
"updated_at": "2026-09-02T16:01:14.6852654+00:00",
"is_published": true
},
"error": null,
"meta": {
"request_id": "req_7X9zKp2jDw",
"timestamp": "2026-09-17T16:01:14.6852662+00:00",
"version": "v3"
}
}{
"success": false,
"data": null,
"error": {
"code": "VALIDATION_003",
"message": "Invalid identifier format",
"details": {
"id": [
"Invalid template ID format."
]
},
"doc_url": "https://docs.sent.dm/reference/api/error-catalog"
},
"meta": {
"request_id": "req_7X9zKp2jDw",
"timestamp": "2026-09-17T16:01:14.6852713+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/reference/api/error-catalog"
},
"meta": {
"request_id": "req_7X9zKp2jDw",
"timestamp": "2026-09-17T16:01:14.6852718+00:00",
"version": "v3"
}
}{
"success": false,
"data": null,
"error": {
"code": "INTERNAL_001",
"message": "An unexpected error occurred",
"details": null,
"doc_url": "https://docs.sent.dm/reference/api/error-catalog"
},
"meta": {
"request_id": "req_7X9zKp2jDw",
"timestamp": "2026-09-17T16:01:14.6852725+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. There is no `name` field on create — the display name is derived from the template's content and can be changed afterwards with `PUT /v3/templates/{id}`.