infoOverview
About this API
Create a new email template for the authenticated user
keySecurity
Authentication
Include your API credential in the request header. Keep credentials on the server and never expose them in client-side applications.
Locationheader
Field name
Authorization: Bearer <TOKEN>Example value
YOUR_ACCESS_TOKENuploadInput
Request Body
Send a application/json payload. Replace placeholder values with data from your integration.
Top-Level Fields
NameTypeRequirementDescription
namestringRequiredName of the template.enginestringNot specifiedTemplate engine used (e.g., handlebars, liquid). Defaults to handlebars.body_htmlstringNot specifiedHTML body for the template. Either body_html or body_text is required.body_textstringNot specifiedPlain text body for the template. Either body_html or body_text is required.is_activebooleanNot specifiedWhether this template is active. Defaults to true.subject_linestringNot specifiedDefault subject line for this template (optional).thumbnail_urlstringNot specifiedOptional thumbnail URL used for previewing the template.required_variablesarrayNot specifiedList of variables required by this template (e.g., {{firstName}}).{}
{
"type": "object",
"required": [
"name"
],
"properties": {
"name": {
"type": "string",
"description": "Name of the template."
},
"engine": {
"type": "string",
"nullable": true,
"description": "Template engine used (e.g., handlebars, liquid). Defaults to handlebars."
},
"body_html": {
"type": "string",
"nullable": true,
"description": "HTML body for the template. Either body_html or body_text is required."
},
"body_text": {
"type": "string",
"nullable": true,
"description": "Plain text body for the template. Either body_html or body_text is required."
},
"is_active": {
"type": "boolean",
"nullable": true,
"description": "Whether this template is active. Defaults to true."
},
"subject_line": {
"type": "string",
"nullable": true,
"description": "Default subject line for this template (optional)."
},
"thumbnail_url": {
"type": "string",
"nullable": true,
"description": "Optional thumbnail URL used for previewing the template."
},
"required_variables": {
"type": "array",
"items": {
"type": "string"
},
"nullable": true,
"description": "List of variables required by this template (e.g., {{firstName}})."
}
}
}
codeIntegration
Code Examples
Select your language and customize the request URL. Credential placeholders are intentionally preserved so secrets never appear in generated samples.
shield_lockCredentials protectedAdd secrets only in your secure server environment.
curl --request POST 'https://email.1spoc.com/api/user/templates' \
--header 'Authorization: Bearer <TOKEN>' \
--header 'Content-Type: application/json' \
--data '{}'
const response = await fetch('https://email.1spoc.com/api/user/templates', {
method: 'POST',
headers: {
"Authorization": "Bearer <TOKEN>",
"Content-Type": "application/json"
},
body: JSON.stringify({})
});
if (!response.ok) throw new Error(`HTTP ${response.status}`);
const data = await response.json();
console.log(data);
const response = await fetch('https://email.1spoc.com/api/user/templates', {
method: 'POST',
headers: {
"Authorization": "Bearer <TOKEN>",
"Content-Type": "application/json"
},
body: JSON.stringify({})
});
if (!response.ok) throw new Error(`HTTP ${response.status}`);
const data = await response.json();
console.log(data);
import json
import requests
url = 'https://email.1spoc.com/api/user/templates'
headers = {
"Authorization": "Bearer <TOKEN>",
"Content-Type": "application/json"
}
payload = json.loads(r'''{}''')
response = requests.post(url, headers=headers, json=payload)
response.raise_for_status()
print(response.json())
import java.net.URI;
import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpResponse;
var client = HttpClient.newHttpClient();
String body = """
{}
""";
var request = HttpRequest.newBuilder(URI.create("https://email.1spoc.com/api/user/templates"))
.header("Authorization", "Bearer <TOKEN>")
.header("Content-Type", "application/json")
.method("POST", HttpRequest.BodyPublishers.ofString(body))
.build();
var response = client.send(request, HttpResponse.BodyHandlers.ofString());
System.out.println(response.statusCode());
System.out.println(response.body());
<?php
$curl = curl_init();
$payload = '{}';
curl_setopt_array($curl, [
CURLOPT_URL => 'https://email.1spoc.com/api/user/templates',
CURLOPT_RETURNTRANSFER => true,
CURLOPT_CUSTOMREQUEST => 'POST',
CURLOPT_HTTPHEADER => ["Authorization: Bearer <TOKEN>","Content-Type: application/json"],
CURLOPT_POSTFIELDS => $payload,
]);
$response = curl_exec($curl);
if ($response === false) throw new Exception(curl_error($curl));
curl_close($curl);
echo $response;
using System.Net.Http.Headers;
using System.Text;
using var client = new HttpClient();
client.DefaultRequestHeaders.Authorization = AuthenticationHeaderValue.Parse("Bearer <TOKEN>");
var json = """
{}
""";
using var content = new StringContent(json, Encoding.UTF8, "application/json");
var response = await client.PostAsync("https://email.1spoc.com/api/user/templates", content);
response.EnsureSuccessStatusCode();
Console.WriteLine(await response.Content.ReadAsStringAsync());
package main
import (
"fmt"
"io"
"net/http"
"bytes"
)
func main() {
request, err := http.NewRequest("POST", "https://email.1spoc.com/api/user/templates", bytes.NewBufferString("{}"))
if err != nil { panic(err) }
request.Header.Set("Content-Type", "application/json")
request.Header.Set("Accept", "application/json")
request.Header.Set("Authorization", "Bearer <TOKEN>")
response, err := http.DefaultClient.Do(request)
if err != nil { panic(err) }
defer response.Body.Close()
data, err := io.ReadAll(response.Body)
if err != nil { panic(err) }
if response.StatusCode >= 400 { panic(fmt.Sprintf("HTTP %d: %s", response.StatusCode, data)) }
fmt.Println(string(data))
}
downloadOutput
Response
A successful request returns the documented response payload. Delivery and asynchronous events may arrive separately through configured webhooks.
{}
{
"$ref": "#/components/schemas/EmailTemplate"
}
ruleHTTP Responses
Status Codes
201Template created successfully.400Missing required fields or invalid body (e.g., missing both body_html and body_text).401Unauthorized (missing or invalid user access token)409Template with this name already exists for the user500Internal server error