Templates: Bearbeiten
Template erstellen
Speichert Ihr eigenes html als Template: aus MJML, React Email, von Ihrem Designer oder aus jedem anderen Tool. Es erscheint im Dashboard neben den Editor-Templates.
https://g.sendcorex.com/v1/templatecommand: create_templateErfordert den Scope template:create für Ihren API key.
Bis zu 30 Aufrufe pro Minute und Konto. Darüber antwortet der Befehl mit RATE_LIMITED.
Das html wird beim Speichern geprüft, mit denselben Regeln wie beim Senden: Sie erfahren es jetzt, nicht erst, wenn eine E-Mail abgelehnt wird.
Die erste Version wird mitgespeichert. Siehe List Template Versions.
Argumente
namestringerforderlichBis zu 255 Zeichen, kein HTML.
z. B.
"Welcome email"htmlstringerforderlichDas vollständige html, bis zu 512 KB. Verwenden Sie
{{variables}}für das, was sich pro E-Mail ändert.z. B.
"<!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>"textstringoptionalDie Nur-Text-Version.
z. B.
"Welcome, {{first_name}}! Your {{plan}} plan is ready. Get started: https://acme.com/start"subjectstringoptionalEin Standardbetreff. Kann Variablen enthalten.
z. B.
"Welcome to Acme, {{first_name}}"
Schnellstart
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);Antwort
{
"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"
}
}
]
}Antwortfelder
template_idDie ID des Templates:
html_<uuid>,unlayer_<number>odercustom_<uuid>. Verwenden Sie sie in allen anderen Befehlen.typehtml(Ihres, über die API gesendet),unlayer(im Drag-and-drop-Editor erstellt) odercustom(im Sendcorex-Editor erstellt).nameDer Name, den Sie ihm gegeben haben.
referenceEin kurzer Code, der das Template auch im Dashboard identifiziert.
previewEin Bild des Templates, bei Editor-Templates.
nullbei html-Templates und bei noch nicht gespeicherten Editor-Templates.has_htmlfalsebei einem Editor-Template, das erstellt, aber nie gespeichert wurde. Es kann noch nicht gerendert oder gesendet werden.html_sizeGröße des html in Bytes.
editabletruebei html-Templates: Sie können sie hier aktualisieren, wiederherstellen und löschen. Editor-Templates sind über die API schreibgeschützt.created_at / updated_atISO 8601, UTC.
subjectDer Standardbetreff oder
null. Kann Variablen enthalten.htmlDas html.
nullbei einem Editor-Template, das nie gespeichert wurde.textDie Nur-Text-Version oder
null. Senden Sie eine mit: Manche Clients und Filter bevorzugen E-Mails, die eine haben.
Variablen
SyntaxSchreiben Sie
{{name}}an beliebiger Stelle in Betreff, html oder Text. Leerzeichen in den Klammern sind in Ordnung:{{ name }}. Namen bestehen aus Buchstaben, Ziffern,_,.und-.Im htmlWerte werden HTML-escaped: Ein Wert mit
<oder&kann Ihr Layout nie zerstören oder Markup einschleusen.In Betreff und TextWerte werden unverändert eingesetzt.
Fehlende WerteEine Variable, die Sie nicht gesendet haben, bleibt als
{{name}}stehen und wird inmissing_variablesaufgeführt. Prüfen Sie es vor dem Senden.
Was das html enthalten darf
ErlaubtAlles, was E-Mail-Clients darstellen: Tabellen, Inline-Styles,
<style>-Blöcke, Bilder per URL, Links.Abgelehnt<script>,<iframe>,<form>,<input>,<button>,<embed>,<object>, Inline-<svg>,<base>,on*=-Handler undjavascript:-URLs. Verwenden Sie statt eines Buttons ein gestyltes<a>.BilderHosten und verlinken Sie sie. Eingebettete Base64-Bilder machen das html schwer und werden von Gmail ab ca. 100 KB oft abgeschnitten.
Fehler
Fehler auf HTTP-Ebene liefern type, code und message. Mit CMD markierte Fehler kommen im Befehlsergebnis zurück, mit HTTP 200.
- 401
INVALID_API_KEYDer API key existiert nicht, wurde widerrufen oder im Dashboard deaktiviert.
- 429
RATE_LIMITEDMehr als 15 Requests/s oder 15 gleichzeitig für dieselbe IP + API key. Warten Sie die Anzahl Sekunden aus Retry-After ab.
- CMD
MISSING_SCOPEDer API key hat nicht den Scope, den dieser Befehl braucht.
- CMD
INVALID_ARGSEin Argument ist ungültig: eine fehlerhafte `template_id`, fehlendes `name` oder `html`, ein Name über 255 Zeichen, ein `version_at`, das nicht RFC 3339 entspricht…
- CMD
UNSAFE_HTMLDas html enthält etwas, das eine E-Mail nicht transportieren kann: `<script>`, `<iframe>`, Formulare, `on*=`-Handler, `javascript:`-Links… Die Meldung sagt genau, was zu entfernen ist.
- CMD
TEMPLATE_TOO_LARGEDas html ist größer als 512 KB. Hosten und verlinken Sie Ihre Bilder, statt sie einzubetten.
- CMD
RATE_LIMITEDIhr Konto hat diesen Befehl in der letzten Minute zu oft aufgerufen. Warten Sie eine Minute.
- CMD
INTERNALServerfehler. Details werden nur ins Server-Log geschrieben.