# Gestionar los suscriptores

> Añade personas a una lista de contactos, edítalas, activa o desactiva su indicador Subscribed y quítalas, en el panel o con la API de 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](/es/docs/audiences/).
- Comprueba cuánto espacio le queda a la lista. El límite cuenta todos los suscriptores, incluidos los dados de baja. Consulta [Límites](/es/docs/audiences/#limits).
- Para la API, usa una clave de API con **Full Access**.

## Añadir un suscriptor

**Panel**

  1. **Abre la lista.** Ve a **Email Marketing → Audiences** y selecciona la lista.

  2. **Añade a la persona.** Selecciona **Add subscriber** e introduce el **Email** y, si quieres, **First name** y **Last name**.

  3. **Guarda.** Selecciona **Add**. Si no existe ningún contacto con esa dirección, Emailit lo crea.

  También puedes añadir contactos existentes desde **Email Marketing → Contacts**: abre un contacto y selecciona **Add to audience**, o selecciona varios contactos y usa **Actions > Add to audience**. Para añadir muchas personas a la vez, [importa un archivo](/es/docs/contacts/import-export/).

**API**

  Llama a [Añadir un suscriptor](/es/docs/api-reference/audiences/subscribers/add/) con el ID o el nombre de la lista:

```bash
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" }
  }'
```

```json
{
  "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"
}
```

  Solo `email` es obligatorio. Si pasas `first_name`, `last_name` o `custom_fields` para un contacto existente, sobrescriben los valores del contacto, y `custom_fields` sustituye el objeto entero.

### 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:

| Estado actual | Resultado | Respuesta de la API |
| --- | --- | --- |
| No está en la lista | Se crea un suscriptor nuevo con **Subscribed** activado. | `201` |
| Está en la lista, con **Subscribed** activado | No cambia nada. El panel muestra «Contact is already subscribed to this audience». | `409` con el suscriptor en `existing` |
| Está en la lista, dado de baja | El suscriptor se vuelve a suscribir: **Subscribed** se activa, `subscribed_at` pasa a la hora actual y `unsubscribed_at` se vacía. | `200` |
| La lista está llena | No se añade nada. | `422` con `usage` |

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.

> **Precaución:** Volver a añadir a alguien que se ha dado de baja lo vuelve a suscribir. Hazlo solo cuando la persona haya pedido volver a unirse, por ejemplo registrándose en tu sitio web.

## 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](/es/docs/api-reference/audiences/subscribers/update/). 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`:

```bash
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`.

| Dónde | Dar de baja | Volver a suscribir |
| --- | --- | --- |
| Página de la lista | **Edit** y desactiva **Subscribed** | **Edit** y activa **Subscribed** |
| Página del contacto | **Unsubscribe** en el menú de la fila de la lista | **Resubscribe** en el menú de la fila |
| API | [Actualizar un suscriptor](/es/docs/api-reference/audiences/subscribers/update/) con `"subscribed": false` | Actualizar con `"subscribed": true` o [añadir](/es/docs/api-reference/audiences/subscribers/add/) de nuevo la dirección |

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](/es/docs/audiences/unsubscribes/).

## 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](/es/docs/api-reference/audiences/subscribers/delete/).

| | Dar de baja | Quitar |
| --- | --- | --- |
| La persona sigue en la lista | Sí, con **Subscribed** desactivado | No |
| Cuenta para el límite de la lista | Sí | No |
| Se conserva el contacto | Sí | Sí |
| Evento | `subscriber.updated` | `subscriber.deleted`, que inicia las automatizaciones **Removed from audience** |
| Volver a añadir la dirección | Vuelve a suscribir al suscriptor existente | Crea un suscriptor nuevo |

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](/es/docs/api-reference/audiences/subscribers/list/) 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:

```bash
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](/es/docs/api-reference/audiences/subscribers/get/) con el ID `sub_` o la dirección de email.

## Ver también

  - [URL de suscripción](/es/docs/audiences/subscribe-url/): Deja que las personas se añadan solas desde tu sitio web.
  - [Contactos](/es/docs/contacts/): La persona que hay detrás de cada suscriptor.

---
Fuente: https://emailit.com/es/docs/audiences/subscribers/