# Gérer les abonnés

> Ajoutez des personnes à une liste de contacts, modifiez-les, activez ou désactivez leur indicateur Subscribed et retirez-les, dans le tableau de bord ou avec l’API des abonnés.

Un abonné correspond à l’appartenance d’un contact à une liste de contacts. Cette page explique comment ajouter des abonnés, les modifier, les désinscrire ou les réinscrire et les retirer, ainsi que l’effet de chaque modification sur le contact correspondant.

## Avant de commencer

- Créez d’abord la liste. Consultez [Listes de contacts](/fr/docs/audiences/).
- Vérifiez la place disponible dans la liste. La limite compte tous les abonnés, y compris les désinscrits. Consultez [Limites](/fr/docs/audiences/#limits).
- Pour l’API, utilisez une clé API **Full Access**.

## Ajouter un abonné

**Tableau de bord**

  1. **Ouvrez la liste.** Accédez à **Email Marketing → Audiences** et sélectionnez la liste.

  2. **Ajoutez la personne.** Sélectionnez **Add subscriber**, saisissez l’**Email** et, si vous le souhaitez, **First name** et **Last name**.

  3. **Enregistrez.** Sélectionnez **Add**. S’il n’existe aucun contact pour cette adresse, Emailit en crée un.

  Vous pouvez aussi ajouter des contacts existants depuis **Email Marketing → Contacts** : ouvrez un contact et sélectionnez **Add to audience**, ou sélectionnez plusieurs contacts et utilisez **Actions > Add to audience**. Pour ajouter de nombreuses personnes d’un coup, [importez un fichier](/fr/docs/contacts/import-export/).

**API**

  Appelez [Ajouter un abonné](/fr/docs/api-reference/audiences/subscribers/add/) avec l’ID ou le nom de la liste :

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

  Seul `email` est obligatoire. Si vous transmettez `first_name`, `last_name` ou `custom_fields` pour un contact existant, ils remplacent les valeurs du contact, et `custom_fields` remplace l’objet entier.

### Quand la personne figure déjà dans la liste

L’ajout d’une adresse déjà présente dans la liste dépend de son état actuel :

| État actuel | Résultat | Réponse de l’API |
| --- | --- | --- |
| Absente de la liste | Un nouvel abonné est créé avec **Subscribed** activé. | `201` |
| Dans la liste, **Subscribed** activé | Rien ne change. Le tableau de bord affiche « Contact is already subscribed to this audience ». | `409` avec l’abonné dans `existing` |
| Dans la liste, désinscrite | L’abonné est réinscrit : **Subscribed** s’active, `subscribed_at` prend la date actuelle et `unsubscribed_at` est effacé. | `200` |
| La liste est pleine | Rien n’est ajouté. | `422` avec `usage` |

Une réinscription via cet endpoint envoie les événements `subscriber.updated` et `subscriber.resubscribed` et démarre les automatisations **Added to audience**, comme pour un nouvel abonné.

> **Attention:** Ajouter à nouveau une personne qui s’est désinscrite la réinscrit. Ne le faites que si la personne a demandé à revenir, par exemple en s’inscrivant sur votre site.

## Modifier un abonné

Dans le tableau des abonnés de la liste, ouvrez le menu de la ligne et sélectionnez **Edit**. Vous pouvez modifier **First name**, **Last name** et l’interrupteur **Subscribed**. L’adresse e-mail est ici en lecture seule.

Via l’API, appelez [Mettre à jour un abonné](/fr/docs/api-reference/audiences/subscribers/update/). Identifiez l’abonné par son ID `sub_` ou par son adresse e-mail, et envoyez un ou plusieurs des champs `email`, `first_name`, `last_name`, `custom_fields` et `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 }'
```

Les noms, l’adresse e-mail et les champs personnalisés appartiennent au contact, pas à l’abonné. Les modifier ici met à jour le contact partout, y compris dans ses autres listes. Seul `subscribed` est propre à cette liste.

## Activer ou désactiver Subscribed

L’indicateur **Subscribed** détermine si les campagnes envoyées à cette liste atteignent la personne. Le désactiver conserve l’abonné dans la liste, enregistre `unsubscribed_at` et ne touche pas aux autres listes du contact. Le réactiver définit un nouveau `subscribed_at` et efface `unsubscribed_at`.

| Emplacement | Désinscrire | Réinscrire |
| --- | --- | --- |
| Page de la liste | **Edit**, puis désactivez **Subscribed** | **Edit**, puis activez **Subscribed** |
| Page du contact | **Unsubscribe** dans le menu de la ligne de la liste | **Resubscribe** dans le menu de la ligne |
| API | [Mettre à jour un abonné](/fr/docs/api-reference/audiences/subscribers/update/) avec `"subscribed": false` | Mise à jour avec `"subscribed": true`, ou nouvel [ajout](/fr/docs/api-reference/audiences/subscribers/add/) de l’adresse |

Ces modifications envoient un événement `subscriber.updated`. Elles n’enregistrent de désinscription sur aucune campagne : elles n’apparaissent donc pas dans l’onglet **Unsubscribes** d’une campagne. Quand des destinataires se désinscrivent eux-mêmes avec le lien d’une campagne, ils quittent toutes les listes d’un coup. Consultez [Désinscriptions](/fr/docs/audiences/unsubscribes/).

## Retirer un abonné

Retirer un abonné supprime son appartenance à la liste. Sélectionnez **Delete** dans le menu de la ligne sur la page de la liste, **Remove from audience** sur la page du contact, ou appelez [Supprimer un abonné](/fr/docs/api-reference/audiences/subscribers/delete/).

| | Désinscrire | Retirer |
| --- | --- | --- |
| La personne reste dans la liste | Oui, avec **Subscribed** désactivé | Non |
| Compte dans la limite de la liste | Oui | Non |
| Le contact est conservé | Oui | Oui |
| Événement | `subscriber.updated` | `subscriber.deleted`, qui démarre les automatisations **Removed from audience** |
| Nouvel ajout de l’adresse | Réinscrit l’abonné existant | Crée un nouvel abonné |

Préférez la désinscription quand quelqu’un se désabonne, afin d’en garder une trace. Retirez les abonnés ajoutés par erreur ou que vous ne voulez plus conserver. Pour supprimer complètement la personne, supprimez le contact, ce qui le retire de toutes les listes.

## Lister et rechercher des abonnés

Sur la page de la liste, recherchez par adresse e-mail ou par nom, et filtrez par Email, First name, Last name, Subscribed ou Created.

Via l’API, [Lister les abonnés](/fr/docs/api-reference/audiences/subscribers/list/) renvoie tous les abonnés, y compris les désinscrits. Ajoutez `subscribed=true` ou `subscribed=false` pour restreindre la liste, `search` pour filtrer sur l’adresse e-mail ou les noms, et `page` et `limit` (100 au maximum) pour parcourir les pages :

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

Pour rechercher une personne, utilisez [Récupérer un abonné](/fr/docs/api-reference/audiences/subscribers/get/) avec l’ID `sub_` ou l’adresse e-mail.

## Voir aussi

  - [URL d’inscription](/fr/docs/audiences/subscribe-url/): Laissez les personnes s’inscrire elles-mêmes depuis votre site.
  - [Contacts](/fr/docs/contacts/): La personne derrière chaque abonné.

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