Templates : Édition
Mettre à jour un template
Modifie le nom, le html, le texte ou l'objet d'un template html. Chaque modification enregistre une version pour pouvoir revenir en arrière : les 10 dernières sont conservées.
https://g.sendcorex.com/v1/templatecommand: update_templateNécessite le scope template:update sur votre API key.
Jusqu'à 60 appels par minute et par compte. Au-delà, la commande répond RATE_LIMITED.
N'envoyez que ce qui change. text ou subject à null ou "" le vide.
Les templates Unlayer et Custom répondent TEMPLATE_READ_ONLY : modifiez-les dans le dashboard.
Arguments
template_idstringobligatoireUn template html.
ex. :
"html_5f2c8a10-3d4e-4b6f-9a71-2c8e0d4b7a93"namestringfacultatifJusqu'à 255 caractères, sans HTML.
ex. :
"Welcome email v2"htmlstringfacultatifLe nouveau html, jusqu'à 512 KB. Vérifié comme dans Create Template.
textstring | nullfacultatifLa nouvelle version texte brut.
subjectstring | nullfacultatifLe nouvel objet par défaut.
ex. :
"Welcome aboard, {{first_name}}"
Démarrage rapide
import axios from 'axios';
const response = await axios.post(
'https://g.sendcorex.com/v1/template',
{
commands: [
{
command: "update_template",
args: {
template_id: "html_5f2c8a10-3d4e-4b6f-9a71-2c8e0d4b7a93",
subject: "Welcome aboard, {{first_name}}"
}
}
]
},
{ 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": "update_template",
"id": "0",
"type": "SUCCESS",
"took_ms": 8,
"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:31:08.447Z",
"subject": "Welcome aboard, {{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.
Garder les templates dans votre repo
Une seule source de véritéGardez le html dans votre code et appelez Update Template depuis votre déploiement. Votre équipe relit les templates comme n'importe quelle autre modification.
Rollbacks sûrsSi un déploiement casse un template, Restore Template Version restaure la dernière bonne version en un appel.
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
TEMPLATE_NOT_FOUNDLe template n'existe pas dans votre compte.
- CMD
TEMPLATE_READ_ONLYUn template Unlayer ou Custom : modifiez-le dans l'éditeur du dashboard. Seuls les templates html se modifient via l'API.
- 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.