Templates : Templates
Lister les templates
Tous les templates de votre compte, ceux créés dans les éditeurs du dashboard et ceux envoyés via l'API, du dernier modifié au plus ancien. Sans le html : utilisez Get Template pour cela.
https://g.sendcorex.com/v1/templatecommand: list_templatesNécessite le scope template:read sur votre API key.
Arguments
typestringfacultatifUn seul type :
html,unlayeroucustom.ex. :
"html"with_htmlbooleanfacultatiftruemasque les templates d'éditeur jamais enregistrés (ils n'ont encore rien à envoyer).ex. :
true
Démarrage rapide
import axios from 'axios';
const response = await axios.post(
'https://g.sendcorex.com/v1/template',
{
commands: [
{
command: "list_templates",
args: {
with_html: true
}
}
]
},
{ 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": "list_templates",
"id": "0",
"type": "SUCCESS",
"took_ms": 7,
"data": {
"templates": [
{
"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"
},
{
"template_id": "unlayer_1284",
"type": "unlayer",
"name": "October newsletter",
"reference": "B3VN8QK1ZT",
"preview": "https://res.cloudinary.com/dmg04ffuy/image/upload/v1760000000/previews/oct_newsletter.png",
"has_html": true,
"html_size": 48211,
"editable": false,
"created_at": "2026-10-01T09:12:00.000Z",
"updated_at": "2026-10-18T16:40:22.118Z"
},
{
"template_id": "custom_9b7e4c21-0d3a-4e8f-a6b1-5c2d7e9f1a30",
"type": "custom",
"name": "Order receipt",
"reference": "Q8XW2MR9DC",
"preview": "https://res.cloudinary.com/dmg04ffuy/image/upload/v1760000000/previews/receipt.png",
"has_html": true,
"html_size": 19734,
"editable": false,
"created_at": "2026-08-14T11:30:05.000Z",
"updated_at": "2026-09-30T08:02:47.551Z"
}
]
}
}
]
}Champs de la réponse
templatesVos templates, du dernier modifié au plus ancien. Vide si vous n'en avez aucun.
templates[].template_idL'id du template :
html_<uuid>,unlayer_<number>oucustom_<uuid>. Utilisez-le dans toutes les autres commandes.templates[].typehtml(le vôtre, envoyé via l'API),unlayer(créé dans l'éditeur drag-and-drop) oucustom(créé dans l'éditeur Sendcorex).templates[].nameLe nom que vous lui avez donné.
templates[].referenceUn code court qui identifie aussi le template dans le dashboard.
templates[].previewUne image du template, pour les templates des éditeurs.
nullpour les templates html et pour les templates d'éditeur pas encore enregistrés.templates[].has_htmlfalsepour un template d'éditeur créé mais jamais enregistré. Il ne peut pas encore être rendu ni envoyé.templates[].html_sizeTaille du html, en octets.
templates[].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.templates[].created_at / updated_atISO 8601, UTC.
Types de templates
htmlVotre propre html : fait avec MJML, React Email, par votre designer, peu importe. Créez-le, modifiez-le, restaurez-le et supprimez-le via l'API.
unlayerCréé dans l'éditeur drag-and-drop du dashboard. Lisez-le et rendez-le ici ; modifiez-le dans le dashboard.
customCréé dans l'éditeur Sendcorex du dashboard. Lisez-le et rendez-le ici ; modifiez-le dans le dashboard.
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
INTERNALErreur serveur. Le détail n'est écrit que dans le log du serveur.