Zur Dokumentation springen
API

Ein Template anlegen

Ein Entwurf, sofern Sie nicht um Veröffentlichung bitten. Ein Entwurf kann in der Vorschau angesehen und nicht versendet werden.

POSTapi.openemail.uk/templates

Führt den echten Aufruf gegen Ihren Workspace aus, mit Ihrem eigenen Schlüssel.

POST /templates

Ein Entwurf, sofern Sie nicht um Veröffentlichung bitten. Ein Entwurf kann in der Vorschau angesehen und nicht versendet werden.

Beispiel

Benötigt templates:write. Liefert 201. slug wird aus dem Namen abgeleitet, wenn Sie ihn weglassen, und ist der Bezeichner, den man im Code festschreibt, denn ein Name ist das, was jemand umbenennt.

curl
curl -X POST "$OE/templates" -H "$AUTH" -H "Content-Type: application/json" \  -d '{    "name": "Order shipped",    "engine": "html",    "subject": "Order {{orderId}} is on its way",    "html": "<p>Hello {{customer}}, {{orderId}} left the warehouse.</p>",    "props": [      { "key": "orderId", "kind": "text", "required": true },      { "key": "customer", "kind": "text", "default": "there" }    ],    "publish": true  }'
Response
{  "object": "template",  "id": "tpl_9c1f0a4b7e05d3862c1f0a44",  "name": "Order shipped",  "slug": "order-shipped",  "description": null,  "status": "active",  "publishedVersion": 1,  "latestVersion": 1,  "subject": "Order {{orderId}} is on its way",  "engine": "html",  "slots": [],  "props": [    { "key": "orderId", "kind": "text", "required": true, "default": null },    { "key": "customer", "kind": "text", "required": false, "default": "there" }  ],  "createdAt": "2026-08-30T10:41:02.000Z",  "updatedAt": "2026-08-30T10:41:02.000Z"}

Setzen Sie publish: true aus einem Deploy-Skript heraus. Ohne das erhalten Sie Version 1 als Entwurf, was richtig ist, wenn ein Mensch den Text zuerst lesen soll, und falsch in allem Automatisierten.

Ein doppelter Name ist template_name_taken, ein doppelter Slug template_slug_taken, beides 409er auf der Connection und nicht auf dem Konto.

Eine Connection fasst 200 Templates. Das 201. ergibt template_limit_reached, eine Absicherung gegen ein außer Kontrolle geratenes Skript, kein Tariflimit.