# Listes de contacts

> Les listes de contacts sont les listes auxquelles vos campagnes sont envoyées. Créez des listes, gérez les abonnés, vérifiez la limite d’abonnés de votre forfait et utilisez les listes via l’API.

Une liste de contacts est un ensemble nommé de contacts, comme « Newsletter » ou « Nouveautés produit ». Vous choisissez une ou plusieurs listes comme destinataires d’une [campagne](/fr/docs/campaigns/), et vous pouvez ajouter des personnes à une liste manuellement, par import, via l’API ou avec une URL d’inscription hébergée.

## Fonctionnement des listes de contacts

Chaque personne d’une liste est un **abonné** : un lien entre un [contact](/fr/docs/contacts/) et la liste, avec son propre indicateur **Subscribed**. Un même contact peut figurer dans plusieurs listes, être abonné à certaines et désinscrit d’autres.

- **Les campagnes** sont envoyées aux abonnés dont l’indicateur **Subscribed** est activé, dont le contact n’est pas désinscrit de toutes les listes et dont l’adresse n’est pas bloquée. Un contact présent dans plusieurs des listes sélectionnées reçoit un seul exemplaire.
- **La désinscription** désactive l’indicateur mais conserve l’abonné dans la liste, ce qui préserve l’historique. Consultez [Désinscriptions](/fr/docs/audiences/unsubscribes/).
- **Supprimer un abonné** retire la personne de la liste. Le contact reste dans votre espace de travail.

## La page Audiences

Accédez à **Email Marketing → Audiences** pour voir vos listes avec leur **Name**, leurs **Subscribers** et leur date **Created**. La colonne **Subscribers** indique le nombre d’abonnés de chaque liste par rapport à la limite de votre forfait, par exemple `1.2k/10k`. Utilisez le menu de la ligne pour gérer les abonnés (**Manage subscribers**), renommer (**Rename**) ou supprimer (**Delete**) une liste.

Pour en créer une, sélectionnez **Create audience**, saisissez un **Name** et sélectionnez **Create**. Les noms doivent être uniques dans l’espace de travail.

## La page d’une liste

Ouvrez une liste pour gérer ses abonnés. L’en-tête affiche le nombre d’abonnés et le badge de limite, avec ces actions :

| Action | Effet |
| --- | --- |
| **Rename** | Modifie le nom de la liste. |
| **Subscribe URL** | Affiche l’URL d’inscription hébergée de cette liste et permet de la réinitialiser. Voir [URL d’inscription](/fr/docs/audiences/subscribe-url/). |
| **Add subscriber** | Ajoute une personne à partir de son adresse e-mail. Remplacé par **Upgrade** quand une liste sur Pay as you go est pleine. |
| **Delete** (dans le menu) | Supprime la liste et tous ses abonnés. Les contacts restent dans votre espace de travail. Cette action est irréversible. |

En dessous, le tableau des abonnés affiche **Email**, **First name**, **Last name**, **Subscribed** et **Created**, avec une recherche, des filtres et un menu de ligne pour modifier (**Edit**) ou supprimer (**Delete**) chaque abonné. Consultez [Gérer les abonnés](/fr/docs/audiences/subscribers/).

## Limites

Chaque forfait limite le nombre d’abonnés qu’une liste peut contenir. Le nombre de listes n’est pas limité.

| | Pay as you go | Pro | Business | Custom |
| --- | --- | --- | --- | --- |
| Abonnés par liste | 10 000 | 50 000 | 250 000 | Illimité |

La limite compte tous les abonnés de la liste, y compris les personnes désinscrites. Pour faire de la place, supprimez les abonnés dont vous n’avez plus besoin, [passez à un forfait supérieur](/fr/docs/billing/plans/) ou demandez une limite plus élevée avec **Request Increase** sur la carte **Sending Limits** de la page d’accueil du tableau de bord.

Quand une liste est pleine, **Add subscriber** est désactivé et tout ajout de personnes, y compris via l’API, les imports et l’URL d’inscription, est rejeté avec `422` et un message comme « Pro includes 50,000 subscribers per audience. ». L’erreur de l’API inclut l’objet `usage` actuel :

```json
{
  "error": "Pro includes 50,000 subscribers per audience.",
  "usage": { "used": 50000, "limit": 50000, "plan": "pro" }
}
```

## Utiliser l’API

L’[API des listes](/fr/docs/api-reference/audiences/) permet de [créer](/fr/docs/api-reference/audiences/create/), [récupérer](/fr/docs/api-reference/audiences/get/), [renommer](/fr/docs/api-reference/audiences/update/), [lister](/fr/docs/api-reference/audiences/list/) et [supprimer](/fr/docs/api-reference/audiences/delete/) des listes, et l’[API des abonnés](/fr/docs/api-reference/audiences/subscribers/) gère les personnes qui y figurent. Vous pouvez utiliser le nom d’une liste au lieu de son ID `aud_` dans l’URL. L’API nécessite une clé API **Full Access**.

```bash
curl https://api.emailit.com/v2/audiences \
  -X POST \
  -H "Authorization: Bearer $EMAILIT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "name": "Newsletter" }'
```

Les réponses portant sur une liste incluent `subscribers_count` et un objet `usage` avec `used`, `limit` et `plan`. La création, la récupération et la mise à jour d’une liste renvoient aussi son `token`, la partie secrète de son [URL d’inscription](/fr/docs/audiences/subscribe-url/). Un nom en double renvoie `409`.

## Événements

Les modifications des listes et des abonnés produisent des événements que vous pouvez recevoir avec des [webhooks](/fr/docs/webhooks/) et qui démarrent des [automatisations](/fr/docs/automations/) :

| Événement | Déclenché lorsque |
| --- | --- |
| [`audience.created`, `audience.updated`, `audience.deleted`](/fr/docs/webhooks/events/audience/) | Une liste est créée, renommée ou supprimée. La suppression d’une liste n’envoie pas d’événement pour chacun de ses abonnés. |
| [`subscriber.created`](/fr/docs/webhooks/events/subscriber/) | Une personne est ajoutée à une liste depuis le tableau de bord ou l’API. Démarre les automatisations **Added to audience**. |
| [`subscriber.updated`](/fr/docs/webhooks/events/subscriber/) | Les informations d’un abonné ou son indicateur **Subscribed** changent. |
| [`subscriber.deleted`](/fr/docs/webhooks/events/subscriber/) | Un abonné est retiré. Démarre les automatisations **Removed from audience**. |

Les imports et l’URL d’inscription n’envoient pas d’événements d’abonné.

## Étapes suivantes

  - [Gérer les abonnés](/fr/docs/audiences/subscribers/): Ajoutez, modifiez, désinscrivez et retirez des personnes.
  - [URL d’inscription](/fr/docs/audiences/subscribe-url/): Collectez des inscriptions depuis votre propre site.
  - [Désinscriptions](/fr/docs/audiences/unsubscribes/): Le fonctionnement des désinscriptions d’une liste à l’autre.
  - [Envoyer une campagne](/fr/docs/campaigns/create/): Envoyez un e-mail aux abonnés de vos listes.

---
Source: https://emailit.com/fr/docs/audiences/