# Listas

El servicio Lists permite a los administradores del tenant crear listas de contactos con nombre, añadir personas mediante CSV o selección de usuarios y usarlas para segmentar las API de Campaigns y Audiences.

## Casos de uso

- Importa un CSV de clientes potenciales o suscriptores para incluirlos en una campaña.
- Agrupa usuarios existentes para volver a interactuar con ellos.
- Compara los envíos de Postal con las listas para medir aperturas y clics por lista.

## Fuentes de miembros

- **Importación CSV**: importa un archivo público con una columna `email`. Los correos sin cuenta se guardan como entradas solo de email.
- **Selección de usuarios**: añade mediante `user_id`; el email se obtiene automáticamente.
- **Email directo**: añade direcciones sin procesar. Si se proporcionan `first_name` y `last_name` y el usuario no existe, se crea con el tipo indicado (predeterminado: `newsletter`).

## Tipos de miembro

El campo `type` indica cómo se añadió: `newsletter` (formulario de suscripción), `contact` (lead importado sin cuenta), `customer` (comprador existente) o cualquier cadena personalizada.

## Analítica

`GET /v1/lists/:list_id/analytics` cruza los emails de los miembros con los envíos de Postal para un `email_type` y devuelve las tasas de apertura, clics y entrega de la lista.