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.
  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

Per modificare una versione pubblicata, annulla prima la pubblicazione:

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

La versione torna a Draft. 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  →  Invia con templateVersionId
                    ↑                              |
                    └──── Annulla pub. per editare ┘

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