Guide pratique
Gérer les abonnés
Ajoutez et importez des personnes dans une liste de contacts, modifiez-les, activez ou désactivez leur indicateur Subscribed, retirez-les et faites-le en masse, 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.
- Vérifiez la place disponible dans la liste. La limite compte tous les abonnés, y compris les désinscrits. Consultez Limites.
- Pour l’API, utilisez une clé API Full Access.
Ajouter un abonné
-
Ouvrez la liste. Accédez à Email MarketingAudiences et sélectionnez la liste.
-
Ajoutez la personne. Sélectionnez Add subscriber, saisissez l’Email et, si vous le souhaitez, First name et Last name.
-
Enregistrez. Sélectionnez Add. S’il n’existe aucun contact pour cette adresse, Emailit en crée un.
Lorsque le double opt-in est activé sur la liste, Ask them to confirm by email first (double opt-in) est coché : la personne reçoit l’e-mail de double opt-in et rejoint la liste quand elle clique sur son lien. Décochez la case pour l’ajouter immédiatement. Lorsque la liste a un e-mail de confirmation, Send the confirmation email l’envoie à la personne que vous ajoutez.
Vous pouvez aussi ajouter des contacts existants depuis Email MarketingContacts : 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.
Appelez Ajouter un abonné avec l’ID ou le nom de la liste :
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" }
}'{
"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.
Transmettez "double_opt_in": true pour envoyer l’e-mail de double opt-in de la liste au lieu d’ajouter la personne immédiatement ; la réponse est alors 202 avec "status": "pending". Transmettez "send_confirmation_email": true pour envoyer l’e-mail de confirmation de la liste après l’ajout.
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é.
Importer des abonnés
Pour ajouter de nombreuses personnes d’un coup, ouvrez la liste et sélectionnez Import. Téléversez un fichier CSV ou Excel de 2 500 lignes au maximum, associez ses colonnes aux champs du contact, vérifiez l’aperçu et sélectionnez Import. Toutes les personnes du fichier sont ajoutées à cette liste ; les contacts qui n’existent pas encore sont créés.
Les imports s’exécutent en arrière-plan : les nouveaux abonnés apparaissent au bout d’un instant. Ils ne demandent pas de double opt-in, n’envoient pas l’e-mail de confirmation et n’envoient pas d’événements d’abonné. Pour importer dans plusieurs listes à la fois, utilisez l’import de la liste Contacts. Consultez Importer et exporter des contacts.
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é. 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 :
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é avec "subscribed": false |
Mise à jour avec "subscribed": true, ou nouvel ajout 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.
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é.
| 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.
Actions en masse
Sélectionnez des abonnés avec les cases à cocher, puis utilisez Actions :
- Subscribe active Subscribed.
- Unsubscribe désactive Subscribed et conserve les personnes dans la liste.
- Remove from audience supprime leurs inscriptions à la liste. Les contacts sont conservés.
Pour agir au-delà d’une page, sélectionnez toute la page avec la case à cocher de l’en-tête, puis Select all matching subscribers. Cela sélectionne toutes les personnes correspondant à la vue actuelle (All, Engaged ou Unengaged) et à la recherche, dans la limite de 10 000 personnes. Chaque modification envoie les mêmes événements qu’une modification manuelle de l’abonné.
Via l’API, appelez Modifier des abonnés en masse avec 1 000 ID d’abonnés au maximum, ou avec "all_matching": true et un filtre engagement ou subscribed facultatif.
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, Subscribed at, Last opened or clicked ou Added. Sélectionnez l’en-tête d’une colonne pour trier selon celle-ci. Last opened or clicked indique la dernière ouverture ou le dernier clic du contact sur un e-mail de votre espace de travail, et les vues Engaged et Unengaged répartissent les personnes abonnées selon la règle d’inactivité de la liste.
Via l’API, Lister les abonnés renvoie tous les abonnés, y compris les désinscrits. Ajoutez subscribed=true ou subscribed=false pour restreindre la liste, engagement=engaged ou engagement=unengaged pour séparer selon l’engagement, search pour filtrer sur l’adresse e-mail ou les noms, order et direction pour trier, et page et limit (100 au maximum) pour parcourir les pages :
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é avec l’ID sub_ ou l’adresse e-mail.