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
https://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
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
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
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_idhtml_<uuid>, unlayer_<number> ou custom_<uuid>. Le préfixe indique le type.
editabletrue 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.
previewUne 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 repoAnnulez 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 VersionUtilisez 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 TemplateRepérez les données manquantes
missing_variables liste chaque {{variable}} que vous n'avez pas remplie. Vérifiez-le avant d'envoyer.
VariablesRéférence complète
Tout ce qui est marqué CMD est une commande envoyée via POST /v1/template, up to 10 per request.