Templates

Tus templates, desde el editor o desde tu código

Lee los templates que tu equipo crea en los editores del dashboard, o trae tu propio html y gestiónalo como código: variables, comprobaciones al guardar y versiones que puedes revertir.

  • Comandos JSON
  • Trae tu propio html
  • Variables
  • 10 versiones
  • Comprobado al guardar
POSThttps://g.sendcorex.com/v1/templatetemplate:*

Cómo funciona

Tres tipos, una API

Drag-and-drop (Unlayer), el editor de Sendcorex (Custom) y tu propio html se listan, leen y renderizan de la misma forma.

Sin atarte a un editor

¿Hiciste tu email con MJML, React Email o un diseñador? Envía el html. Se comprueba al guardar con las mismas reglas que el envío, así que un template que se guarda es un template que se envía.

Versiones incluidas

Cada cambio de un template html guarda una versión. Un deploy malo está a un Restore Template Version de quedar arreglado.

Primeros pasos

Solo necesitas la key antes de tu primera solicitud.

  1. 1

    Crea una API key con scopes de template

    En el dashboard, abre Developers → API Keys y dale a la key template:read, además de template:create, template:update y template:delete si gestiona tu propio html.

    El token del webmail no funciona aquí. Esta API usa la API key del dashboard.

  2. 2

    Guarda tu html

    Create Template con un nombre y el html. Usa {{variables}} para lo que cambia en cada email.

  3. 3

    Renderiza y envía

    Render Template rellena las variables y te dice cuáles faltan. Pasa el resultado a Send Email.

El template

Get Template, Create Template y Update Template devuelven esta estructura. List Templates la devuelve sin subject, html ni text.

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

html_<uuid>, unlayer_<number> o custom_<uuid>. El prefijo es el tipo.

editable

true para tu propio html. Los templates de los editores son de solo lectura a través de la API.

{{variables}}

Placeholders en el asunto, el html y el texto, rellenados por Render Template.

preview

Una imagen de los templates de los editores, para tu propio selector de templates. null para los templates html.

Tu primera solicitud

Guarda un email de bienvenida con dos variables. Reemplaza SENDCOREX_API_KEY por tu API key.

curl -X POST 'https://g.sendcorex.com/v1/template' \
  -H "Authorization: $SENDCOREX_API_KEY" \
  -H 'Content-Type: application/json' \
  -d '{
  "commands": [
    { "command": "create_template", "args": { "name": "Welcome email", "subject": "Welcome, {{first_name}}", "html": "<h1>Hi {{first_name}}</h1><p>Your {{plan}} plan is ready.</p>" } }
  ]
}'

Recibes el template con su template_id. Renderízalo con variables para ver el email final. La misma solicitud en 8 lenguajes está en Create Template.

Tareas comunes

Templates como código

Mantén el html en tu repositorio y súbelo con Update Template en cada deploy. Se revisa como cualquier cambio.

Mantener los templates en tu repositorio

Deshaz un cambio malo

Lista las versiones y restaura la última buena. La restauración también es una versión, así que se puede deshacer.

Restore Template Version

Usa lo que diseña tu equipo

Marketing crea el email en el editor; tu código lo lee con Get Template y lo envía.

Get Template

Detecta datos que faltan

missing_variables lista cada {{variable}} que no rellenaste. Revísalo antes de enviar.

Variables

Referencia completa

Todo lo marcado como CMD es un comando enviado a través de POST /v1/template, up to 10 per request.