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.

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

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

i

Jusqu'à 60 appels par minute et par compte. Au-delà, la commande répond RATE_LIMITED.

i

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_idstringobligatoire

    Un template html.

    ex. : "html_5f2c8a10-3d4e-4b6f-9a71-2c8e0d4b7a93"

  • namestringfacultatif

    Jusqu'à 255 caractères, sans HTML.

    ex. : "Welcome email v2"

  • htmlstringfacultatif

    Le nouveau html, jusqu'à 512 KB. Vérifié comme dans Create Template.

  • textstring | nullfacultatif

    La nouvelle version texte brut.

  • subjectstring | nullfacultatif

    Le 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_id

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

  • type

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

  • name

    Le nom que vous lui avez donné.

  • reference

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

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

  • has_html

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

  • html_size

    Taille du html, en octets.

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

  • created_at / updated_at

    ISO 8601, UTC.

  • subject

    L'objet par défaut, ou null. Peut contenir des variables.

  • html

    Le html. null pour un template d'éditeur jamais enregistré.

  • text

    La 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ûrs

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

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

  • CMDTEMPLATE_NOT_FOUND

    Le template n'existe pas dans votre compte.

  • CMDTEMPLATE_READ_ONLY

    Un template Unlayer ou Custom : modifiez-le dans l'éditeur du dashboard. Seuls les templates html se modifient via l'API.

  • CMDUNSAFE_HTML

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

  • CMDTEMPLATE_TOO_LARGE

    Le html dépasse 512 KB. Hébergez vos images et liez-les au lieu de les intégrer.

  • CMDRATE_LIMITED

    Votre compte a appelé cette commande trop de fois au cours de la dernière minute. Attendez une minute.

  • CMDINTERNAL

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