curl --request POST \
--url https://api.sendx.io/api/v1/rest/template/email \
--header 'Content-Type: application/json' \
--header 'X-Team-ApiKey: <api-key>' \
--data '
{
"name": "Weekly Newsletter Template",
"htmlCode": "<div class=\"newsletter\"><h1>{{company.name}} Weekly Update</h1><div class=\"content\">{{email.content}}</div></div>",
"templateCode": "{\"type\":\"doc\",\"content\":[{\"type\":\"paragraph\",\"attrs\":{\"textAlign\":null,\"showIfKey\":null},\"content\":[{\"type\":\"text\",\"text\":\"This is a new template\"}]}]}",
"editorType": 1
}
'
{
"id": "template_abc123def456ghi789",
"name": "Welcome Email Template",
"subject": "Welcome to our platform!",
"htmlCode": "<html><body><h1>Welcome!</h1></body></html>",
"templateCode": "{\"blocks\":[{\"type\":\"text\",\"content\":\"Welcome!\"}]}",
"type": 0,
"thumbnail": "https://cdn.sendx.io/templates/thumb_abc123.png",
"editorType": 1,
"created": "2024-01-10T14:20:00Z",
"updated": "2024-01-15T09:15:00Z"
}{
"status": 401,
"message": "The Team ID or API Key specified is not valid"
}{
"status": "error",
"message": "Resource with this name already exists"
}{
"status": "error",
"message": "Request body is not in proper format"
}{
"status": "error",
"message": "Internal server error occurred"
}Template
Create email template
Creates a new reusable email template.
POST
/
template
/
email
curl --request POST \
--url https://api.sendx.io/api/v1/rest/template/email \
--header 'Content-Type: application/json' \
--header 'X-Team-ApiKey: <api-key>' \
--data '
{
"name": "Weekly Newsletter Template",
"htmlCode": "<div class=\"newsletter\"><h1>{{company.name}} Weekly Update</h1><div class=\"content\">{{email.content}}</div></div>",
"templateCode": "{\"type\":\"doc\",\"content\":[{\"type\":\"paragraph\",\"attrs\":{\"textAlign\":null,\"showIfKey\":null},\"content\":[{\"type\":\"text\",\"text\":\"This is a new template\"}]}]}",
"editorType": 1
}
'
{
"id": "template_abc123def456ghi789",
"name": "Welcome Email Template",
"subject": "Welcome to our platform!",
"htmlCode": "<html><body><h1>Welcome!</h1></body></html>",
"templateCode": "{\"blocks\":[{\"type\":\"text\",\"content\":\"Welcome!\"}]}",
"type": 0,
"thumbnail": "https://cdn.sendx.io/templates/thumb_abc123.png",
"editorType": 1,
"created": "2024-01-10T14:20:00Z",
"updated": "2024-01-15T09:15:00Z"
}{
"status": 401,
"message": "The Team ID or API Key specified is not valid"
}{
"status": "error",
"message": "Resource with this name already exists"
}{
"status": "error",
"message": "Request body is not in proper format"
}{
"status": "error",
"message": "Internal server error occurred"
}🎯 Key Features:
- HTML and text versions
- Personalization variables
- Reusable across campaigns
- Template versioning
- PlainText (0): Basic text formatting, fast loading
- DragDrop (1): Visual components, responsive design using the bee editor
- SendxEditor (2): TipTap editor with advanced features like drag & drop, image upload, and more
- Reusable email designs
- Consistent branding across campaigns
Authorizations
Team API key for authentication. Find your API key in SendX Settings → Team API Key.
Example:
X-Team-ApiKey: your_team_api_key_here
Body
application/json
Response
✅ Template created successfully
Unique template identifier with template_ prefix
Pattern:
^template_[a-zA-Z0-9]{22}$Example:
"template_abc123def456ghi789"
Name of the template
Example:
"Welcome Email Template"
Email subject line (if applicable)
Example:
"Welcome to our platform!"
HTML content of the template
Example:
"<html><body><h1>Welcome!</h1></body></html>"
Template code for visual editors (JSON structure)
Example:
"{\"blocks\":[{\"type\":\"text\",\"content\":\"Welcome!\"}]}"
Template type.
Values:
0- Email template1- Other types
Example:
0
URL to template thumbnail image
Example:
"https://cdn.sendx.io/templates/thumb_abc123.png"
Editor type used to create the template.
Values:
0- PlainText1- DragDrop2- SendxEditor
Example:
1
Template creation timestamp
Example:
"2024-01-10T14:20:00Z"
Template last update timestamp
Example:
"2024-01-15T09:15:00Z"
Was this page helpful?