Templates: Edición

Crear plantilla

Guarda tu propio html como template: de MJML, React Email, tu diseñador o cualquier herramienta. Aparece en el dashboard junto a los templates de los editores.

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

Requiere el scope template:create en tu API key.

i

Hasta 30 llamadas por minuto por cuenta. Por encima, el comando responde RATE_LIMITED.

i

El html se comprueba al guardar, con las mismas reglas que el envío: te enteras ahora, no cuando se rechaza un email.

i

La primera versión se guarda con él. Consulta List Template Versions.

Argumentos

  • namestringobligatorio

    Hasta 255 caracteres, sin HTML.

    p. ej. "Welcome email"

  • htmlstringobligatorio

    El html completo, hasta 512 KB. Usa {{variables}} para lo que cambia en cada email.

    p. ej. "<!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>"

  • textstringopcional

    La versión en texto plano.

    p. ej. "Welcome, {{first_name}}! Your {{plan}} plan is ready. Get started: https://acme.com/start"

  • subjectstringopcional

    Un asunto por defecto. Puede tener variables.

    p. ej. "Welcome to Acme, {{first_name}}"

Inicio rápido

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);

Respuesta

{
  "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"
      }
    }
  ]
}

Campos de la respuesta

  • template_id

    El id del template: html_<uuid>, unlayer_<number> o custom_<uuid>. Úsalo en todos los demás comandos.

  • type

    html (tuyo, enviado por la API), unlayer (creado en el editor drag-and-drop) o custom (creado en el editor de Sendcorex).

  • name

    El nombre que le diste.

  • reference

    Un código corto que también identifica el template en el dashboard.

  • preview

    Una imagen del template, para los templates de los editores. null para los templates html y para los de editor aún no guardados.

  • has_html

    false para un template de editor que se creó pero nunca se guardó. Todavía no se puede renderizar ni enviar.

  • html_size

    Tamaño del html, en bytes.

  • editable

    true para los templates html: puedes actualizarlos, restaurarlos y eliminarlos aquí. Los templates de los editores son de solo lectura a través de la API.

  • created_at / updated_at

    ISO 8601, UTC.

  • subject

    El asunto por defecto, o null. Puede tener variables.

  • html

    El html. null para un template de editor que nunca se guardó.

  • text

    La versión en texto plano, o null. Envía una: algunos clientes y filtros prefieren los emails que la tienen.

Variables

  • Sintaxis

    Escribe {{name}} en cualquier parte del asunto, el html o el texto. Los espacios dentro de las llaves están bien: {{ name }}. Los nombres usan letras, dígitos, _, . y -.

  • En el html

    Los valores se escapan como HTML: un valor con < o & nunca puede romper tu diseño ni inyectar marcado.

  • En el asunto y el texto

    Los valores se insertan tal cual.

  • Valores que faltan

    Una variable que no enviaste se queda como {{name}} y aparece en missing_variables. Revísalo antes de enviar.

Qué puede tener el html

  • Permitido

    Todo lo que renderizan los clientes de email: tablas, estilos inline, bloques <style>, imágenes por URL, enlaces.

  • Rechazado

    <script>, <iframe>, <form>, <input>, <button>, <embed>, <object>, <svg> inline, <base>, handlers on*= y URLs javascript:. Usa un <a> con estilos en lugar de un botón.

  • Imágenes

    Alójalas y enlázalas. Las imágenes base64 incrustadas hacen pesado el html y Gmail suele recortarlas a partir de ~100 KB.

Errores

Los errores a nivel HTTP devuelven type, code y message. Los errores marcados con CMD vuelven dentro del resultado del comando, con HTTP 200.

  • 401INVALID_API_KEY

    La API key no existe, fue revocada o se desactivó en el dashboard.

  • 429RATE_LIMITED

    Más de 15 solicitudes/s o 15 simultáneas para la misma IP + API key. Espera el número de segundos indicado en Retry-After.

  • CMDMISSING_SCOPE

    La API key no tiene el scope que necesita este comando.

  • CMDINVALID_ARGS

    Un argumento no es válido: un `template_id` mal formado, falta `name` o `html`, un nombre de más de 255 caracteres, un `version_at` que no es RFC 3339…

  • CMDUNSAFE_HTML

    El html tiene algo que un email no puede llevar: `<script>`, `<iframe>`, formularios, handlers `on*=`, enlaces `javascript:`… El mensaje dice exactamente qué quitar.

  • CMDTEMPLATE_TOO_LARGE

    El html supera los 512 KB. Aloja tus imágenes y enlázalas en lugar de incrustarlas.

  • CMDRATE_LIMITED

    Tu cuenta llamó a este comando demasiadas veces en el último minuto. Espera un minuto.

  • CMDINTERNAL

    Error del servidor. El detalle solo se escribe en el log del servidor.