Templates

Vos templates, depuis l'éditeur ou depuis votre code

Lisez les templates que votre équipe crée dans les éditeurs du dashboard, ou apportez votre propre html et gérez-le comme du code : variables, vérification à l'enregistrement et versions que vous pouvez restaurer.

  • Commandes JSON
  • Votre propre html
  • Variables
  • 10 versions
  • Vérifié à l'enregistrement
POSThttps://g.sendcorex.com/v1/templatetemplate:*

Fonctionnement

Trois types, une API

Le drag-and-drop (Unlayer), l'éditeur Sendcorex (Custom) et votre propre html se listent, se lisent et se rendent de la même façon.

Pas enfermé dans un éditeur

Vous avez fait votre e-mail avec MJML, React Email ou un designer ? Envoyez le html. Il est vérifié à l'enregistrement avec les mêmes règles qu'à l'envoi : un template qui s'enregistre est un template qui s'envoie.

Versions incluses

Chaque modification d'un template html enregistre une version. Un mauvais déploiement se corrige avec un simple Restore Template Version.

Premiers pas

Seule la key est nécessaire avant votre première requête.

  1. 1

    Créez une API key avec les scopes template

    Dans le dashboard, ouvrez Developers → API Keys et donnez à la key template:read, plus template:create, template:update et template:delete si elle gère votre propre html.

    Le token du webmail ne fonctionne pas ici. Cette API utilise l'API key du dashboard.

  2. 2

    Enregistrez votre html

    Create Template avec un nom et le html. Utilisez des {{variables}} pour ce qui change d'un e-mail à l'autre.

  3. 3

    Rendez et envoyez

    Render Template remplit les variables et vous indique celles qui manquent. Passez le résultat à Send Email.

Le template

Get Template, Create Template et Update Template renvoient cette structure. List Templates la renvoie sans subject, html ni 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_id

html_<uuid>, unlayer_<number> ou custom_<uuid>. Le préfixe indique le type.

editable

true pour votre propre html. Les templates des éditeurs sont en lecture seule via l'API.

{{variables}}

Des placeholders dans l'objet, le html et le texte, remplis par Render Template.

preview

Une image des templates des éditeurs, pour votre propre sélecteur de templates. null pour les templates html.

Votre première requête

Enregistrez un e-mail de bienvenue avec deux variables. Remplacez SENDCOREX_API_KEY par votre 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>" } }
  ]
}'

Vous recevez le template avec son template_id. Rendez-le avec des variables pour voir l'e-mail final. La même requête en 8 langages se trouve dans Create Template.

Cas d'usage courants

Templates as code

Gardez le html dans votre repo et poussez-le avec Update Template à chaque déploiement. Relu comme n'importe quelle modification.

Garder les templates dans votre repo

Annulez une mauvaise modification

Listez les versions et restaurez la dernière bonne. La restauration est elle aussi une version, donc elle peut être annulée.

Restore Template Version

Utilisez ce que votre équipe conçoit

Le marketing crée l'e-mail dans l'éditeur ; votre code le lit avec Get Template et l'envoie.

Get Template

Repérez les données manquantes

missing_variables liste chaque {{variable}} que vous n'avez pas remplie. Vérifiez-le avant d'envoyer.

Variables

Référence complète

Tout ce qui est marqué CMD est une commande envoyée via POST /v1/template, up to 10 per request.