Templates : Édition
Créer un template
Enregistre votre propre html comme template : depuis MJML, React Email, votre designer ou n'importe quel outil. Il apparaît dans le dashboard à côté des templates des éditeurs.
https://g.sendcorex.com/v1/templatecommand: create_templateNécessite le scope template:create sur votre API key.
Jusqu'à 30 appels par minute et par compte. Au-delà, la commande répond RATE_LIMITED.
Le html est vérifié à l'enregistrement, avec les mêmes règles qu'à l'envoi : vous le savez maintenant, pas quand un e-mail est refusé.
La première version est enregistrée avec lui. Voir List Template Versions.
Arguments
namestringobligatoireJusqu'à 255 caractères, sans HTML.
ex. :
"Welcome email"htmlstringobligatoireLe html complet, jusqu'à 512 KB. Utilisez des
{{variables}}pour ce qui change d'un e-mail à l'autre.ex. :
"<!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>"textstringfacultatifLa version texte brut.
ex. :
"Welcome, {{first_name}}! Your {{plan}} plan is ready. Get started: https://acme.com/start"subjectstringfacultatifUn objet par défaut. Peut contenir des variables.
ex. :
"Welcome to Acme, {{first_name}}"
Démarrage rapide
import axios from 'axios';
const response = await axios.post(
'https://g.sendcorex.com/v1/template',
{
commands: [
{
command: "create_template",
args: {
name: "Welcome email",
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"
}
}
]
},
{ headers: { Authorization: process.env.SENDCOREX_API_KEY } },
);
const [result] = response.data.results;
if (result.type !== 'SUCCESS') throw new Error(`${result.code}: ${result.message}`);
console.log(result.data);Réponse
{
"type": "SUCCESS",
"results": [
{
"command": "create_template",
"id": "0",
"type": "SUCCESS",
"took_ms": 9,
"data": {
"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"
}
}
]
}Champs de la réponse
template_idL'id du template :
html_<uuid>,unlayer_<number>oucustom_<uuid>. Utilisez-le dans toutes les autres commandes.typehtml(le vôtre, envoyé via l'API),unlayer(créé dans l'éditeur drag-and-drop) oucustom(créé dans l'éditeur Sendcorex).nameLe nom que vous lui avez donné.
referenceUn code court qui identifie aussi le template dans le dashboard.
previewUne image du template, pour les templates des éditeurs.
nullpour les templates html et pour les templates d'éditeur pas encore enregistrés.has_htmlfalsepour un template d'éditeur créé mais jamais enregistré. Il ne peut pas encore être rendu ni envoyé.html_sizeTaille du html, en octets.
editabletruepour les templates html : vous pouvez les modifier, les restaurer et les supprimer ici. Les templates des éditeurs sont en lecture seule via l'API.created_at / updated_atISO 8601, UTC.
subjectL'objet par défaut, ou
null. Peut contenir des variables.htmlLe html.
nullpour un template d'éditeur jamais enregistré.textLa version texte brut, ou
null. Fournissez-en une : certains clients et filtres préfèrent les e-mails qui en ont une.
Variables
SyntaxeÉcrivez
{{name}}n'importe où dans l'objet, le html ou le texte. Les espaces entre les accolades sont acceptés :{{ name }}. Les noms utilisent des lettres, des chiffres,_,.et-.Dans le htmlLes valeurs sont échappées en HTML : une valeur contenant
<ou&ne peut jamais casser votre mise en page ni injecter du balisage.Dans l'objet et le texteLes valeurs sont insérées telles quelles.
Valeurs manquantesUne variable que vous n'avez pas envoyée reste
{{name}}et apparaît dansmissing_variables. Vérifiez-le avant d'envoyer.
Ce que le html peut contenir
AutoriséTout ce que les clients e-mail affichent : tableaux, styles inline, blocs
<style>, images par URL, liens.Refusé<script>,<iframe>,<form>,<input>,<button>,<embed>,<object>,<svg>inline,<base>, handlerson*=et URLjavascript:. Utilisez un<a>stylé au lieu d'un bouton.ImagesHébergez-les et liez-les. Les images base64 intégrées alourdissent le html et sont souvent tronquées par Gmail au-delà d'environ 100 KB.
Erreurs
Les erreurs au niveau HTTP renvoient type, code et message. Les erreurs marquées CMD reviennent dans le résultat de la commande, avec HTTP 200.
- 401
INVALID_API_KEYL'API key n'existe pas, a été révoquée ou a été désactivée dans le dashboard.
- 429
RATE_LIMITEDPlus de 15 requêtes/s ou 15 simultanées pour la même IP + API key. Attendez le nombre de secondes indiqué dans Retry-After.
- CMD
MISSING_SCOPEL'API key n'a pas le scope dont cette commande a besoin.
- CMD
INVALID_ARGSUn argument est invalide : un `template_id` mal formé, un `name` ou un `html` manquant, un nom de plus de 255 caractères, un `version_at` qui n'est pas au format RFC 3339…
- CMD
UNSAFE_HTMLLe html contient quelque chose qu'un e-mail ne peut pas transporter : `<script>`, `<iframe>`, formulaires, handlers `on*=`, liens `javascript:`… Le message indique exactement quoi retirer.
- CMD
TEMPLATE_TOO_LARGELe html dépasse 512 KB. Hébergez vos images et liez-les au lieu de les intégrer.
- CMD
RATE_LIMITEDVotre compte a appelé cette commande trop de fois au cours de la dernière minute. Attendez une minute.
- CMD
INTERNALErreur serveur. Le détail n'est écrit que dans le log du serveur.