Aller à la documentation
API

Créer un modèle

Un brouillon, sauf si vous demandez sa publication. Un brouillon peut être prévisualisé et ne peut pas être envoyé.

POSTapi.openemail.uk/templates

Exécute le véritable appel sur votre espace de travail, avec votre propre clé.

POST /templates

Un brouillon, sauf si vous demandez sa publication. Un brouillon peut être prévisualisé et ne peut pas être envoyé.

Exemple

Nécessite templates:write. Renvoie 201. slug est dérivé du nom quand vous l'omettez, et c'est la référence à figer dans le code, car le nom est ce que quelqu'un renomme.

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  }'
Réponse
{  "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"}

Mettez publish: true depuis un script de déploiement. Sans cela, vous obtenez la version 1 en brouillon, ce qui convient quand une personne va d'abord relire le texte et ne convient pas dans un processus automatisé.

Un nom en double donne template_name_taken et un slug en double template_slug_taken, deux 409 portant sur la connexion plutôt que sur le compte.

Une connexion contient 200 modèles. Le 201e donne template_limit_reached, un garde-fou contre un script emballé, pas une limite de forfait.