Gérer les 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é

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

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 :

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é.

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.

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é.

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 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 :

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.

Voir aussi