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.

POSThttps://g.sendcorex.com/v1/templatecommand: list_templates
i

Nécessite le scope template:read sur votre API key.

Arguments

  • typestringfacultatif

    Un seul type : html, unlayer ou custom.

    ex. : "html"

  • with_htmlbooleanfacultatif

    true masque 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

  • templates

    Vos templates, du dernier modifié au plus ancien. Vide si vous n'en avez aucun.

  • templates[].template_id

    L'id du template : html_<uuid>, unlayer_<number> ou custom_<uuid>. Utilisez-le dans toutes les autres commandes.

  • templates[].type

    html (le vôtre, envoyé via l'API), unlayer (créé dans l'éditeur drag-and-drop) ou custom (créé dans l'éditeur Sendcorex).

  • templates[].name

    Le nom que vous lui avez donné.

  • templates[].reference

    Un code court qui identifie aussi le template dans le dashboard.

  • templates[].preview

    Une image du template, pour les templates des éditeurs. null pour les templates html et pour les templates d'éditeur pas encore enregistrés.

  • templates[].has_html

    false pour un template d'éditeur créé mais jamais enregistré. Il ne peut pas encore être rendu ni envoyé.

  • templates[].html_size

    Taille du html, en octets.

  • templates[].editable

    true pour 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_at

    ISO 8601, UTC.

Types de templates

  • html

    Votre 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.

  • unlayer

    Créé dans l'éditeur drag-and-drop du dashboard. Lisez-le et rendez-le ici ; modifiez-le dans le dashboard.

  • custom

    Créé 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.

  • 401INVALID_API_KEY

    L'API key n'existe pas, a été révoquée ou a été désactivée dans le dashboard.

  • 429RATE_LIMITED

    Plus 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.

  • CMDMISSING_SCOPE

    L'API key n'a pas le scope dont cette commande a besoin.

  • CMDINVALID_ARGS

    Un 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…

  • CMDINTERNAL

    Erreur serveur. Le détail n'est écrit que dans le log du serveur.