MailingCore
DocumentazioneFlusso di pubblicazione

Flusso di pubblicazione

POST .../publish, CSS inline e annullamento pubblicazione.

La pubblicazione blocca una versione template per l'uso in produzione e prepara l'HTML per i client email.

Pubblicare una versione

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

Richiede JWT del pannello (la gestione template non e disponibile con API key al momento).

Cosa succede alla pubblicazione

  1. CSS inline — i blocchi <style> esterni e i fogli collegati vengono inlined negli attributi HTML dove possibile. Migliora il rendering nei client che rimuovono gli stili dal <head> (Gmail, Outlook).
  2. Lo stato passa da Draft a Published. Qualsiasi versione pubblicata precedente dello stesso template viene archiviata automaticamente — c'e sempre al massimo una versione pubblicata.
  3. L'ID versione diventa valido per templateVersionId in POST /emails/send e nelle campagne.
{
  "id": "clxversion...",
  "status": "PUBLISHED",
  "publishedAt": "2026-06-30T10:00:00.000Z"
}

Annullare pubblicazione

La pubblicazione e append-only: una versione pubblicata e immutabile — non puoi modificarla sul posto (l'API restituisce VERSION_NOT_DRAFT). Per cambiare un template in produzione, crea una nuova versione draft, modificala e pubblicala; la pubblicazione archivia la precedente.

Annullare la pubblicazione sposta una versione pubblicata in Archived (non torna a Draft), quindi non e piu selezionabile per nuovi invii:

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

Gli invii gia in coda non sono influenzati; i nuovi invii devono usare un'altra versione pubblicata o htmlBody inline.

Flusso consigliato

Modifica draft  →  Preview  →  Pubblica (archivia la precedente)  →  Invia con templateVersionId
    ↑                                                                  |
    └────────── Crea una NUOVA versione draft per cambiare ───────────┘

Note sul CSS inline

  • Preferisci CSS semplice e compatibile con email (tabelle, proprieta inline-friendly).
  • Layout complessi (molto flexbox) potrebbero non inlinedarsi bene — testa su client reali.
  • Sono supportate esportazioni MJML e Unlayer via mjmlSource e unlayerDesign sulla versione.

Correlati