Ves a la documentació
API

Crear una plantilla

Un esborrany tret que demanis que es publiqui. Un esborrany es pot previsualitzar i no es pot enviar.

POSTapi.openemail.uk/templates

Executa la crida real contra el teu espai de treball, amb la teva pròpia clau.

POST /templates

Un esborrany tret que demanis que es publiqui. Un esborrany es pot previsualitzar i no es pot enviar.

Exemple

Necessita templates:write. Retorna 201. Si l'omets, slug es deriva del nom, i és l'identificador que cal fixar al codi, perquè el nom és allò que algú reanomena.

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  }'
Resposta
{  "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"}

Posa publish: true des d'un script de desplegament. Sense això obtens la versió 1 com a esborrany, cosa que està bé quan una persona ha de llegir el text abans i està malament en qualsevol cosa automatitzada.

Un nom duplicat és template_name_taken i un slug duplicat és template_slug_taken, tots dos 409 a la connexió i no pas al compte.

Una connexió admet 200 plantilles. La 201a és template_limit_reached, una protecció contra un script desbocat, no pas un límit de pla.