Envio por lotes

POST /emails/batch — hasta 100 destinatarios con variables por destinatario.

Envia la misma plantilla a varios destinatarios en una sola peticion. Cada destinatario puede tener sus propias variables de merge.

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

Scope requerido: email:send.

Cuerpo de la peticion

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

Campos

Campo	Requerido	Descripcion
`recipients`	Si	Array de `{ to, vars? }` — max 100 por peticion
`recipients[].to`	Si	Email del destinatario
`recipients[].vars`	No	Mapa para sustituir `{{var}}` en asunto y HTML
`subject`	Si	Asunto (admite `{{var}}`)
`htmlBody`	Si*	Cuerpo HTML (*o `templateVersionId`)
`templateVersionId`	No	Version publicada
`fromEmail`, `fromName`, `replyTo`	No	Remitente en dominio verificado

Respuesta

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

Limites

100 destinatarios maximo por peticion. Usa campanas para audiencias mayores.
Cada aceptado cuenta en la cuota mensual.

Ver Enviar email.