# Listes de contacts

Le service Lists permet aux administrateurs du tenant de créer des listes de contacts nommées, d'y ajouter des personnes par import CSV ou sélection d'utilisateurs et de les utiliser pour cibler les API Campaigns et Audiences.

## Cas d'utilisation

- Importer un CSV de prospects ou d'abonnés à une newsletter pour les cibler dans une campagne.
- Regrouper des utilisateurs existants pour les réengager.
- Comparer les envois Postal aux listes afin de mesurer les ouvertures et clics par liste.

## Sources de membres

- **Import CSV** : importer un fichier accessible publiquement avec une colonne `email`. Les adresses sans compte sont enregistrées comme entrées email uniquement.
- **Sélection d'utilisateurs** : ajouter par `user_id` ; l'adresse email est obtenue automatiquement.
- **Adresse email directe** : ajouter des adresses brutes. Si `first_name` et `last_name` sont fournis et que l'utilisateur n'existe pas, un utilisateur est créé avec le type donné (par défaut : `newsletter`).

## Types de membre

Le champ `type` indique l'origine : `newsletter` (formulaire d'abonnement), `contact` (prospect importé sans compte), `customer` (acheteur existant) ou toute valeur personnalisée.

## Analytique

`GET /v1/lists/:list_id/analytics` rapproche les emails des membres des envois Postal pour un `email_type` donné et renvoie les taux d'ouverture, de clic et de livraison de la liste.