DocumentazioneInvio batch

Invio batch

POST /emails/batch — fino a 100 destinatari con variabili per destinatario.

Invia lo stesso template a piu destinatari in una richiesta. Ogni destinatario puo avere variabili di merge proprie.

POST https://api.mailingcore.com/emails/batch
Authorization: Bearer mc_live_xxxx
X-Tenant-Id: clxxxxxxxx
Content-Type: application/json

Scope richiesto: email:send.

Corpo della richiesta

{
  "recipients": [
    { "to": "[email protected]", "vars": { "name": "Alice" } },
    { "to": "[email protected]", "vars": { "name": "Bob" } }
  ],
  "subject": "Ciao {{name}}",
  "htmlBody": "<p>Ciao {{name}}, benvenuto.</p>",
  "fromEmail": "[email protected]",
  "templateVersionId": "clxversion..."
}

Campi

CampoObbligatorioDescrizione
recipientsSiArray { to, vars? }max 100 per richiesta
recipients[].toSiEmail destinatario
recipients[].varsNoMappa per sostituire {{var}} in oggetto e HTML
subjectSiOggetto (supporta {{var}})
htmlBodySi*Corpo HTML (*o templateVersionId)

Risposta

{
  "results": [
    { "to": "[email protected]", "id": "clxlog...", "status": "QUEUED" },
    { "to": "[email protected]", "id": "", "status": "REJECTED", "error": "Email is suppressed" }
  ],
  "accepted": 1,
  "rejected": 1
}

Limite: 100 destinatari per richiesta. Vedi Invia email e Campagne.