Gestionar los suscriptores

Un suscriptor es la pertenencia de un contacto a una lista de contactos. Esta página explica cómo añadir suscriptores, cambiarlos, darlos de baja o volver a suscribirlos y quitarlos, y qué efecto tiene cada cambio en el contacto que hay detrás.

Antes de empezar

• Crea primero la lista. Consulta Listas de contactos.
• Comprueba cuánto espacio le queda a la lista. El límite cuenta todos los suscriptores, incluidos los dados de baja. Consulta Límites.
• Para la API, usa una clave de API con Full Access.

Añadir un suscriptor

curl https://api.emailit.com/v2/audiences/aud_5hJ2kL8mNp4Qr/subscribers \
  -X POST \
  -H "Authorization: Bearer $EMAILIT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "email": "ada@example.com",
    "first_name": "Ada",
    "last_name": "Lovelace",
    "custom_fields": { "company": "Acme" }
  }'

{
  "object": "subscriber",
  "id": "sub_7Rt2vX9kLm3Qp",
  "audience_id": "aud_5hJ2kL8mNp4Qr",
  "contact_id": "con_2kq8Vt4xLm7Rz",
  "email": "ada@example.com",
  "first_name": "Ada",
  "last_name": "Lovelace",
  "custom_fields": { "company": "Acme" },
  "subscribed": true,
  "subscribed_at": "2026-10-01T09:30:00Z",
  "unsubscribed_at": null,
  "created_at": "2026-10-01T09:30:00Z",
  "updated_at": "2026-10-01T09:30:00Z"
}

Cuando la persona ya está en la lista

Lo que pasa al añadir una dirección que ya está en la lista depende de su estado actual:

Volver a suscribir a alguien mediante este endpoint envía los eventos subscriber.updated y subscriber.resubscribed e inicia las automatizaciones Added to audience, igual que un suscriptor nuevo.

Editar un suscriptor

En la tabla de suscriptores de la lista, abre el menú de la fila y selecciona Edit. Puedes cambiar First name, Last name y el interruptor Subscribed. La dirección de email es de solo lectura aquí.

Con la API, llama a Actualizar un suscriptor. Identifica al suscriptor por su ID sub_ o por su dirección de email, y envía cualquiera de email, first_name, last_name, custom_fields y subscribed:

curl https://api.emailit.com/v2/audiences/Newsletter/subscribers/ada@example.com \
  -X POST \
  -H "Authorization: Bearer $EMAILIT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "first_name": "Augusta", "subscribed": false }'

Los nombres, el email y los campos personalizados pertenecen al contacto, no al suscriptor. Si los cambias aquí, el contacto se actualiza en todas partes, también en sus otras listas. Solo subscribed es específico de esta lista.

Activar o desactivar Subscribed

El indicador Subscribed decide si las campañas a esta lista llegan a la persona. Desactivarlo mantiene al suscriptor en la lista, registra unsubscribed_at y no afecta a las demás listas del contacto. Volver a activarlo define un subscribed_at nuevo y vacía unsubscribed_at.

Estos cambios envían un evento subscriber.updated. No registran una baja en ninguna campaña, así que no aparecen en la pestaña Unsubscribes de una campaña. Cuando los destinatarios se dan de baja ellos mismos con el enlace de una campaña, salen de todas las listas a la vez. Consulta Bajas.

Quitar un suscriptor

Quitar un suscriptor elimina su pertenencia a la lista. Selecciona Delete en el menú de la fila de la página de la lista, Remove from audience en la página del contacto o llama a Eliminar un suscriptor.

Cuando alguien se da de baja, es preferible darlo de baja y no quitarlo, para conservar constancia de ello. Quita los suscriptores que añadiste por error o que ya no quieres conservar. Para eliminar a la persona por completo, elimina el contacto, lo que lo quita de todas las listas.

Listar y buscar suscriptores

En la página de la lista, busca por email o nombre, y filtra por Email, First name, Last name, Subscribed o Created.

Con la API, Listar suscriptores devuelve todos los suscriptores, incluidos los dados de baja. Añade subscribed=true o subscribed=false para acotar la lista, search para buscar en el email o los nombres, y page y limit (hasta 100) para paginar:

curl "https://api.emailit.com/v2/audiences/aud_5hJ2kL8mNp4Qr/subscribers?subscribed=true&limit=100&page=1" \
  -H "Authorization: Bearer $EMAILIT_API_KEY"

Para consultar a una persona, usa Obtener un suscriptor con el ID sub_ o la dirección de email.

Ver también