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
https://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
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
Guarda tu html
Create Template con un nombre y el html. Usa {{variables}} para lo que cambia en cada email.
- 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_idhtml_<uuid>, unlayer_<number> o custom_<uuid>. El prefijo es el tipo.
editabletrue 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.
previewUna 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 repositorioDeshaz 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 VersionUsa 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 TemplateDetecta datos que faltan
missing_variables lista cada {{variable}} que no rellenaste. Revísalo antes de enviar.
VariablesReferencia completa
Todo lo marcado como CMD es un comando enviado a través de POST /v1/template, up to 10 per request.