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.
https://g.sendcorex.com/v1/templatecommand: create_templateRequiere el scope template:create en tu API key.
Hasta 30 llamadas por minuto por cuenta. Por encima, el comando responde RATE_LIMITED.
El html se comprueba al guardar, con las mismas reglas que el envío: te enteras ahora, no cuando se rechaza un email.
La primera versión se guarda con él. Consulta List Template Versions.
Argumentos
namestringobligatorioHasta 255 caracteres, sin HTML.
p. ej.
"Welcome email"htmlstringobligatorioEl 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>"textstringopcionalLa versión en texto plano.
p. ej.
"Welcome, {{first_name}}! Your {{plan}} plan is ready. Get started: https://acme.com/start"subjectstringopcionalUn 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_idEl id del template:
html_<uuid>,unlayer_<number>ocustom_<uuid>. Úsalo en todos los demás comandos.typehtml(tuyo, enviado por la API),unlayer(creado en el editor drag-and-drop) ocustom(creado en el editor de Sendcorex).nameEl nombre que le diste.
referenceUn código corto que también identifica el template en el dashboard.
previewUna imagen del template, para los templates de los editores.
nullpara los templates html y para los de editor aún no guardados.has_htmlfalsepara un template de editor que se creó pero nunca se guardó. Todavía no se puede renderizar ni enviar.html_sizeTamaño del html, en bytes.
editabletruepara 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_atISO 8601, UTC.
subjectEl asunto por defecto, o
null. Puede tener variables.htmlEl html.
nullpara un template de editor que nunca se guardó.textLa versión en texto plano, o
null. Envía una: algunos clientes y filtros prefieren los emails que la tienen.
Variables
SintaxisEscribe
{{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 htmlLos valores se escapan como HTML: un valor con
<o&nunca puede romper tu diseño ni inyectar marcado.En el asunto y el textoLos valores se insertan tal cual.
Valores que faltanUna variable que no enviaste se queda como
{{name}}y aparece enmissing_variables. Revísalo antes de enviar.
Qué puede tener el html
PermitidoTodo 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>, handlerson*=y URLsjavascript:. Usa un<a>con estilos en lugar de un botón.ImágenesAló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.
- 401
INVALID_API_KEYLa API key no existe, fue revocada o se desactivó en el dashboard.
- 429
RATE_LIMITEDMá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.
- CMD
MISSING_SCOPELa API key no tiene el scope que necesita este comando.
- CMD
INVALID_ARGSUn 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…
- CMD
UNSAFE_HTMLEl html tiene algo que un email no puede llevar: `<script>`, `<iframe>`, formularios, handlers `on*=`, enlaces `javascript:`… El mensaje dice exactamente qué quitar.
- CMD
TEMPLATE_TOO_LARGEEl html supera los 512 KB. Aloja tus imágenes y enlázalas en lugar de incrustarlas.
- CMD
RATE_LIMITEDTu cuenta llamó a este comando demasiadas veces en el último minuto. Espera un minuto.
- CMD
INTERNALError del servidor. El detalle solo se escribe en el log del servidor.