MailingCore
DocumentacionFlujo de publicacion

Flujo de publicacion

POST .../publish, CSS inline y despublicar.

Publicar bloquea una version de plantilla para uso en produccion y prepara el HTML para clientes de correo.

Publicar una version

POST /templates/{templateId}/versions/{versionId}/publish
Authorization: Bearer <accessToken>
X-Tenant-Id: clxxxxxxxx

Requiere JWT del panel (la gestion de plantillas no esta disponible con API key actualmente).

Que ocurre al publicar

  1. CSS inline — los bloques <style> externos y hojas enlazadas se inlinedan en atributos HTML cuando es posible. Mejora el render en clientes que eliminan estilos del <head> (Gmail, Outlook).
  2. El estado pasa de Draft a Published. Cualquier version publicada anterior de esa plantilla se archiva automaticamente — siempre hay como maximo una version publicada.
  3. El ID de version es valido para templateVersionId en POST /emails/send y campanas.
{
  "id": "clxversion...",
  "status": "PUBLISHED",
  "publishedAt": "2026-06-30T10:00:00.000Z"
}

Despublicar

Publicar es append-only: una version publicada es inmutable — no puedes editarla en el sitio (la API devuelve VERSION_NOT_DRAFT). Para cambiar una plantilla en vivo, crea una nueva version draft, editala y publicala; al publicar se archiva la anterior.

Despublicar mueve una version publicada a Archived (no vuelve a Draft), asi que deja de poder seleccionarse para nuevos envios:

POST /templates/{templateId}/versions/{versionId}/unpublish

Los envios ya en cola no se ven afectados; los nuevos deben usar otra version publicada o htmlBody inline.

Flujo recomendado

Editar draft  →  Preview  →  Publicar (archiva la anterior)  →  Enviar con templateVersionId
    ↑                                                              |
    └────────── Crea una NUEVA version draft para cambiar ────────┘

Notas sobre CSS inline

  • Prefiere CSS simple y compatible con email (tablas, propiedades inline-friendly).
  • Layouts complejos (mucho flexbox) pueden no inlinedarse bien — prueba en clientes reales.
  • Se admiten exportaciones MJML y Unlayer via mjmlSource y unlayerDesign en la version.

Relacionado