Templates: Edición
Actualizar plantilla
Cambia el nombre, el html, el texto o el asunto de un template html. Cada cambio guarda una versión para que puedas volver atrás: se conservan las últimas 10.
https://g.sendcorex.com/v1/templatecommand: update_templateRequiere el scope template:update en tu API key.
Hasta 60 llamadas por minuto por cuenta. Por encima, el comando responde RATE_LIMITED.
Envía solo lo que cambia. text o subject como null o "" lo borra.
Los templates Unlayer y Custom responden TEMPLATE_READ_ONLY: edítalos en el dashboard.
Argumentos
template_idstringobligatorioUn template html.
p. ej.
"html_5f2c8a10-3d4e-4b6f-9a71-2c8e0d4b7a93"namestringopcionalHasta 255 caracteres, sin HTML.
p. ej.
"Welcome email v2"htmlstringopcionalEl nuevo html, hasta 512 KB. Se comprueba como en Create Template.
textstring | nullopcionalLa nueva versión en texto plano.
subjectstring | nullopcionalEl nuevo asunto por defecto.
p. ej.
"Welcome aboard, {{first_name}}"
Inicio rápido
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);Respuesta
{
"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"
}
}
]
}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.
Mantener los templates en tu repositorio
Una única fuente de verdadMantén el html en tu código y llama a Update Template desde tu deploy. Tu equipo revisa los templates como cualquier otro cambio.
Rollbacks segurosSi un deploy rompe un template, Restore Template Version recupera el último bueno en una llamada.
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
TEMPLATE_NOT_FOUNDEl template no está en tu cuenta.
- CMD
TEMPLATE_READ_ONLYUn template Unlayer o Custom: edítalo en el editor del dashboard. Solo los templates html cambian a través de la API.
- 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.