DocumentacionContactos y audiencia
Contactos y audiencia
Modelo de contacto, externalId y scopes para gestionar tu audiencia.
Los contactos son los destinatarios de tus campanas newsletter. Cada contacto pertenece a un tenant y se identifica de forma estable con externalId (el id en tu sistema CRM, SaaS o base de datos).
Modelo de contacto
| Campo | Descripcion |
|---|---|
email | Direccion del destinatario |
externalId | Identificador unico en tu aplicacion (clave de upsert y borrado GDPR) |
locale | Idioma preferido: es, en, it, fr, ca, de |
optIn | Consentimiento para recibir newsletter |
consentVersion | Version del texto legal aceptado |
source | Origen del alta (formulario, importacion, API) |
projectId | Segmentacion opcional dentro del tenant |
attributes | Metadatos personalizados (allowlist por defecto: sede) |
MailingCore usa externalId para crear o actualizar sin duplicados (PUT /contacts) y para el borrado bajo GDPR (DELETE /contacts/:externalId).
Scopes requeridos
| Operacion | Scope |
|---|---|
| Leer contactos | contacts:read |
| Crear, actualizar, importar, borrar | contacts:write |
Consulta la tabla completa en API keys y scopes.
Autenticacion
Todas las rutas de contactos requieren API key y header multi-tenant:
Authorization: Bearer mc_live_xxxx
X-Tenant-Id: clxxxxxxxx
Ver Multi-tenant si gestionas varios espacios de trabajo.
Relacion con campanas y bajas
- Las campanas filtran audiencia por
locale,optInyprojectIdal crear el envio. - Las bajas actualizan
optIny alimentan la lista de supresion; puedes recibir el eventocontact.unsubscribedvia webhooks.