Campanas

Estados, audiencia filtrada y fan-out de envios newsletter.

Una campana envia una plantilla publicada a un segmento de contactos con optIn activo. El envio se procesa en segundo plano (fan-out): un job por destinatario con la variante de idioma correspondiente.

Scopes

Operacion	Scope
Listar y consultar campanas	`campaigns:read`
Crear, probar, programar, enviar, cancelar	`campaigns:write`

Detalle en API keys y scopes.

Crear campana

POST /campaigns
Authorization: Bearer mc_live_xxxx
X-Tenant-Id: clxxxxxxxx

{
  "name": "Newsletter junio 2026",
  "templateVersionId": "cltemplateversion...",
  "audienceFilter": {
    "locale": "es",
    "optIn": true,
    "projectId": "proyecto-norte"
  }
}

Campo	Descripcion
`name`	Nombre interno de la campana
`templateVersionId`	Version publicada de la plantilla
`audienceFilter.locale`	Filtra contactos por idioma (opcional)
`audienceFilter.optIn`	Solo suscritos cuando es `true`
`audienceFilter.projectId`	Segmento por proyecto (opcional)

Estados del ciclo de vida

Estado	Significado
`DRAFT`	Creada, aun no programada ni enviada
`SCHEDULED`	Envio programado para fecha futura
`SENDING`	Fan-out en curso
(otros)	Transiciones finales segun implementacion (completada, cancelada, error)

Locale y plantillas

MailingCore elige la variante de plantilla asi:

Locale del contacto
Fallback CAMPAIGN_FALLBACK_LOCALE (por defecto es)
Version base de la plantilla

Antes de enviar masivo, revisa Cobertura por idioma.

Siguiente paso

Flujo completo (prueba, programacion, envio) en Crear y enviar campana.