Templates
Ihre Templates, aus dem Editor oder aus Ihrem Code
Lesen Sie die Templates, die Ihr Team in den Dashboard-Editoren erstellt, oder bringen Sie Ihr eigenes html mit und verwalten Sie es wie Code: Variablen, Prüfung beim Speichern und Versionen, die Sie zurückrollen können.
- JSON-Befehle
- Eigenes html
- Variablen
- 10 Versionen
- Beim Speichern geprüft
https://g.sendcorex.com/v1/templatetemplate:*So funktioniert es
Drei Typen, eine API
Drag-and-drop (Unlayer), der Sendcorex-Editor (Custom) und Ihr eigenes html werden alle gleich aufgelistet, gelesen und gerendert.
Nicht an einen Editor gebunden
Ihre E-Mail mit MJML, React Email oder einem Designer erstellt? Senden Sie das html. Es wird beim Speichern mit denselben Regeln wie beim Senden geprüft: Ein Template, das sich speichern lässt, lässt sich auch senden.
Versionen inklusive
Jede Änderung an einem html-Template speichert eine Version. Ein fehlerhafter Deploy ist mit einem Restore Template Version behoben.
Erste Schritte
Vor Ihrem ersten Request brauchen Sie nur den Key.
- 1
API key mit Template-Scopes erstellen
Öffnen Sie im Dashboard Developers → API Keys und geben Sie dem Key template:read, dazu template:create, template:update und template:delete, wenn er Ihr eigenes html verwaltet.
Der Webmail-Token funktioniert hier nicht. Diese API verwendet den API key aus dem Dashboard.
- 2
html speichern
Create Template mit einem Namen und dem html. Verwenden Sie {{variables}} für das, was sich pro E-Mail ändert.
- 3
Rendern und senden
Render Template füllt die Variablen und sagt Ihnen, welche fehlen. Übergeben Sie das Ergebnis an Send Email.
Das Template
Get Template, Create Template und Update Template liefern diese Struktur. List Templates liefert sie ohne subject, html und text.
{
"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"
}template_idhtml_<uuid>, unlayer_<number> oder custom_<uuid>. Das Präfix ist der Typ.
editabletrue für Ihr eigenes html. Editor-Templates sind über die API schreibgeschützt.
{{variables}}Platzhalter in Betreff, html und Text, die Render Template füllt.
previewEin Bild von Editor-Templates, für Ihre eigene Template-Auswahl. null bei html-Templates.
Ihr erster Request
Speichern Sie eine Willkommens-E-Mail mit zwei Variablen. Ersetzen Sie SENDCOREX_API_KEY durch Ihren API key.
curl -X POST 'https://g.sendcorex.com/v1/template' \
-H "Authorization: $SENDCOREX_API_KEY" \
-H 'Content-Type: application/json' \
-d '{
"commands": [
{ "command": "create_template", "args": { "name": "Welcome email", "subject": "Welcome, {{first_name}}", "html": "<h1>Hi {{first_name}}</h1><p>Your {{plan}} plan is ready.</p>" } }
]
}'Sie erhalten das Template mit seiner template_id zurück. Rendern Sie es mit Variablen, um die fertige E-Mail zu sehen. Derselbe Request in 8 Sprachen steht in Create Template.
Häufige Aufgaben
Templates als Code
Halten Sie das html in Ihrem Repo und pushen Sie es bei jedem Deploy mit Update Template. Reviewt wie jede Änderung.
Templates in Ihrem Repo haltenEine fehlerhafte Änderung rückgängig machen
Listen Sie die Versionen auf und stellen Sie die letzte gute wieder her. Die Wiederherstellung ist ebenfalls eine Version und lässt sich rückgängig machen.
Restore Template VersionNutzen, was Ihr Team gestaltet
Das Marketing baut die E-Mail im Editor; Ihr Code liest sie mit Get Template und sendet sie.
Get TemplateFehlende Daten erkennen
missing_variables listet jede {{variable}}, die Sie nicht gefüllt haben. Prüfen Sie es vor dem Senden.
VariablenVollständige Referenz
Alles mit CMD ist ein Befehl, der über POST /v1/template gesendet wird, up to 10 per request.