Templates: Mengedit
Buat template
Menyimpan html Anda sendiri sebagai template: dari MJML, React Email, desainer Anda, atau alat apa pun. Template ini muncul di dashboard di samping template dari editor.
https://g.sendcorex.com/v1/templatecommand: create_templateMembutuhkan scope template:create pada API key Anda.
Hingga 30 panggilan per menit per akun. Jika lebih, perintah menjawab RATE_LIMITED.
html diperiksa saat Anda menyimpan, dengan aturan yang sama seperti saat mengirim: Anda tahu sekarang, bukan saat email ditolak.
Versi pertama ikut disimpan. Lihat List Template Versions.
Argumen
namestringwajibHingga 255 karakter, tanpa HTML.
mis.
"Welcome email"htmlstringwajibhtml lengkap, hingga 512 KB. Gunakan
{{variables}}untuk bagian yang berubah per email.mis.
"<!doctype html><html><body style=\"font-family:Arial,sans-serif\"><h1>Welcome, {{first_name}}!</h1><p>Your {{plan}} plan is ready.</p><p><a href=\"https://acme.com/start\">Get started</a></p></body></html>"textstringopsionalVersi teks biasa.
mis.
"Welcome, {{first_name}}! Your {{plan}} plan is ready. Get started: https://acme.com/start"subjectstringopsionalSubjek default. Bisa berisi variabel.
mis.
"Welcome to Acme, {{first_name}}"
Mulai cepat
import axios from 'axios';
const response = await axios.post(
'https://g.sendcorex.com/v1/template',
{
commands: [
{
command: "create_template",
args: {
name: "Welcome email",
subject: "Welcome to Acme, {{first_name}}",
html: "<!doctype html><html><body style=\"font-family:Arial,sans-serif\"><h1>Welcome, {{first_name}}!</h1><p>Your {{plan}} plan is ready.</p><p><a href=\"https://acme.com/start\">Get started</a></p></body></html>",
text: "Welcome, {{first_name}}! Your {{plan}} plan is ready. Get started: https://acme.com/start"
}
}
]
},
{ headers: { Authorization: process.env.SENDCOREX_API_KEY } },
);
const [result] = response.data.results;
if (result.type !== 'SUCCESS') throw new Error(`${result.code}: ${result.message}`);
console.log(result.data);Respons
{
"type": "SUCCESS",
"results": [
{
"command": "create_template",
"id": "0",
"type": "SUCCESS",
"took_ms": 9,
"data": {
"template_id": "html_5f2c8a10-3d4e-4b6f-9a71-2c8e0d4b7a93",
"type": "html",
"name": "Welcome email",
"reference": "K7Q2M9XR4T",
"preview": null,
"has_html": true,
"html_size": 248,
"editable": true,
"created_at": "2026-10-21T04:02:11.310Z",
"updated_at": "2026-10-21T04:15:40.902Z",
"subject": "Welcome to Acme, {{first_name}}",
"html": "<!doctype html><html><body style=\"font-family:Arial,sans-serif\"><h1>Welcome, {{first_name}}!</h1><p>Your {{plan}} plan is ready.</p><p><a href=\"https://acme.com/start\">Get started</a></p></body></html>",
"text": "Welcome, {{first_name}}! Your {{plan}} plan is ready. Get started: https://acme.com/start"
}
}
]
}Field respons
template_idid template:
html_<uuid>,unlayer_<number>, ataucustom_<uuid>. Gunakan di semua perintah lain.typehtml(milik Anda, dikirim lewat API),unlayer(dibuat di editor drag-and-drop), ataucustom(dibuat di editor Sendcorex).nameNama yang Anda berikan.
referenceKode pendek yang juga mengidentifikasi template di dashboard.
previewGambar template, untuk template editor.
nulluntuk template html dan template editor yang belum disimpan.has_htmlfalseuntuk template editor yang sudah dibuat tetapi belum pernah disimpan. Template ini belum bisa dirender atau dikirim.html_sizeUkuran html, dalam byte.
editabletrueuntuk template html: Anda bisa memperbarui, memulihkan, dan menghapusnya di sini. Template editor hanya bisa dibaca melalui API.created_at / updated_atISO 8601, UTC.
subjectSubjek default, atau
null. Bisa berisi variabel.htmlhtml-nya.
nulluntuk template editor yang belum pernah disimpan.textVersi teks biasa, atau
null. Sertakan satu: beberapa klien dan filter lebih menyukai email yang memilikinya.
Variabel
SintaksTulis
{{name}}di mana saja dalam subjek, html, atau teks. Spasi di dalam kurung kurawal tidak masalah:{{ name }}. Nama memakai huruf, angka,_,., dan-.Di htmlNilai di-escape sebagai HTML: nilai yang mengandung
<atau&tidak akan pernah merusak layout atau menyisipkan markup.Di subjek dan teksNilai dimasukkan apa adanya.
Nilai yang kurangVariabel yang tidak Anda kirim tetap sebagai
{{name}}dan dicantumkan dimissing_variables. Periksa sebelum mengirim.
Apa yang boleh ada di html
DiizinkanApa pun yang dirender klien email: tabel, style inline, blok
<style>, gambar via URL, link.Ditolak<script>,<iframe>,<form>,<input>,<button>,<embed>,<object>,<svg>inline,<base>, handleron*=, dan URLjavascript:. Gunakan<a>yang diberi style sebagai pengganti tombol.GambarHost gambarnya dan tautkan. Gambar base64 yang disematkan membuat html berat dan sering dipotong Gmail setelah ~100 KB.
Error
Error di level HTTP mengembalikan type, code, dan message. Error yang ditandai CMD dikembalikan di dalam hasil perintah, dengan HTTP 200.
- 401
INVALID_API_KEYAPI key tidak ada, telah dicabut, atau dinonaktifkan di dashboard.
- 429
RATE_LIMITEDLebih dari 15 request/dtk atau 15 bersamaan untuk IP + API key yang sama. Tunggu sejumlah detik yang ada di Retry-After.
- CMD
MISSING_SCOPEAPI key tidak memiliki scope yang dibutuhkan perintah ini.
- CMD
INVALID_ARGSAda argumen yang tidak valid: `template_id` yang salah format, `name` atau `html` tidak ada, nama lebih dari 255 karakter, `version_at` yang bukan RFC 3339…
- CMD
UNSAFE_HTMLhtml berisi sesuatu yang tidak bisa dibawa email: `<script>`, `<iframe>`, formulir, handler `on*=`, link `javascript:`… Pesannya menyebutkan persis apa yang harus dihapus.
- CMD
TEMPLATE_TOO_LARGEhtml lebih dari 512 KB. Host gambar Anda dan tautkan, jangan disematkan.
- CMD
RATE_LIMITEDAkun Anda memanggil perintah ini terlalu sering dalam satu menit terakhir. Tunggu satu menit.
- CMD
INTERNALError server. Detailnya hanya ditulis ke log server.