# Gérer les adresses bloquées

> Consultez, filtrez, ajoutez, importez, exportez et supprimez des blocages dans le tableau de bord ou via l’API, configurez le blocage automatique et renvoyez les e-mails bloqués.

Ce guide couvre toutes les tâches liées à la liste d’adresses bloquées : retrouver des entrées, en ajouter une par une ou depuis un fichier CSV, exporter la liste, retirer des entrées et régler le blocage automatique. Pour le fonctionnement des blocages, consultez [Adresses bloquées](/fr/docs/suppressions/).

## Avant de commencer

- Tout membre de l’espace de travail peut gérer la liste dans le tableau de bord. La modification des paramètres de blocage automatique nécessite le rôle Admin.
- Pour l’API, utilisez une clé API **Full Access**.

## Consulter et filtrer la liste

**Tableau de bord**

  Accédez à **Email API → Suppressions**. Le tableau liste l’**Email**, la **Reason** et la date **Created at** de chaque blocage, du plus récent au plus ancien.

  - **Search** recherche dans l’adresse e-mail et le motif.
  - **Filters** ajoute des règles sur **Email**, **Reason**, **Type** ou **Created at**, comme *Type equals complaint*. Appuyez sur Entrée ou sélectionnez **Apply**.
  - **Display options > Edit columns** affiche la colonne **Type**.
  - Sélectionnez un en-tête de colonne pour trier selon cette colonne.

**API**

  Appelez [Lister les blocages](/fr/docs/api-reference/suppressions/list/). Vous pouvez filtrer sur `email`, `reason`, `type`, `created_at` et `keep_until` :

```bash
curl -G https://api.emailit.com/v2/suppressions \
  -H "Authorization: Bearer $EMAILIT_API_KEY" \
  --data-urlencode "type.exact=complaint" \
  --data-urlencode "limit=100"
```

  Pour consulter une adresse précise, appelez [Récupérer un blocage](/fr/docs/api-reference/suppressions/get/) avec son ID `sup_` ou l’adresse e-mail. Pour tous les opérateurs, consultez [Filtrage et tri](/fr/docs/api-reference/filtering/).

## Ajouter un blocage

**Tableau de bord**

  1. **Ouvrez la liste.** Accédez à **Email API → Suppressions** et sélectionnez **Add suppression**.

  2. **Saisissez les informations.** Saisissez l’**Email** et, si vous le souhaitez, une **Reason** que vous reconnaîtrez plus tard.

  3. **Sélectionnez Create.** L’adresse est ajoutée avec le type `recipient`, qui bloque tous les envois vers elle.

  Pour ajouter un autre type, ou un blocage qui expire, utilisez l’API ou un import CSV.

**API**

  Appelez [Créer un blocage](/fr/docs/api-reference/suppressions/create/) :

```bash
curl https://api.emailit.com/v2/suppressions \
  -X POST \
  -H "Authorization: Bearer $EMAILIT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "email": "ada@example.com",
    "type": "unsubscribe",
    "reason": "Opted out by phone",
    "keep_until": "2027-01-01T00:00:00Z"
  }'
```

  | Champ | Obligatoire | Description |
  | --- | --- | --- |
  | `email` | Oui | L’adresse à bloquer. |
  | `type` | Non | `recipient` (par défaut), `bounce`, `complaint` ou `unsubscribe`. |
  | `reason` | Non | Texte libre. |
  | `keep_until` | Non | Date d’expiration du blocage : ISO 8601, horodatage Unix ou anglais courant comme `in 30 days`. Omettez-le pour bloquer l’adresse sans limite de durée. |

  Une même adresse ne peut être ajoutée qu’une fois par type. Un doublon renvoie `409 Suppression already exists for this email and type`.

## Importer un fichier CSV

Utilisez un import pour transférer une liste d’adresses bloquées depuis un autre fournisseur ou pour ajouter de nombreuses adresses à la fois.

1. **Préparez le fichier.** Utilisez un fichier `.csv` avec les colonnes `email`, `type` et `reason` :

```csv title="suppressions.csv"
email,type,reason
ada@example.com,bounce,Hard bounce at previous provider
grace@example.com,unsubscribe,Unsubscribed in 2025
alan@example.com,,Requested removal
```

   - `email` est obligatoire. `type` et `reason` sont facultatifs.
   - Un `type` vide ou inconnu devient `recipient`.
   - La ligne d’en-tête est facultative. Sans elle, Emailit lit les colonnes dans l’ordre `email`, `type`, `reason`.
   - Le fichier doit peser moins de 8 Mo et ne pas dépasser 10 000 lignes.

2. **Importez-le.** Sur **Email API → Suppressions**, sélectionnez **Import**, puis choisissez le fichier ou faites-le glisser sur **Select a file or drag it here**.

3. **Vérifiez le résultat.** Emailit ajoute les nouvelles entrées et ignore les adresses qui ont déjà un blocage du même type. Les lignes dont l’adresse e-mail est invalide sont ignorées.

Au-delà de 10 000 adresses, découpez le fichier. Pour importer depuis votre code, appelez [Créer un blocage](/fr/docs/api-reference/suppressions/create/) pour chaque adresse.

## Exporter la liste

1. **Affinez la sélection.** Si vous le souhaitez, recherchez ou filtrez la liste dans **Email API → Suppressions**. L’export ne contient que ce qui est affiché.

2. **Exportez.** Sélectionnez **Export**, puis **Export** dans la fenêtre contextuelle. Emailit télécharge `suppressions.csv`.

Le fichier comporte les colonnes `email`, `type`, `reason` et `created_at`, et contient jusqu’à 10 000 lignes.

## Supprimer des blocages

Supprimer un blocage permet à Emailit d’envoyer de nouveau à l’adresse. Assurez-vous que l’adresse est valide et que la personne veut recevoir vos e-mails, sinon le prochain envoi risque de rebondir ou de susciter une plainte.

**Tableau de bord**

  - **Un seul :** sélectionnez l’icône de corbeille sur sa ligne et confirmez.
  - **Plusieurs :** sélectionnez les lignes avec les cases à cocher, sélectionnez **Delete suppressions** et confirmez.

**API**

  Appelez [Supprimer un blocage](/fr/docs/api-reference/suppressions/delete/) avec l’ID `sup_` ou l’adresse e-mail :

```bash
curl https://api.emailit.com/v2/suppressions/sup_4Lm8Qr2Tz6Wk \
  -X DELETE \
  -H "Authorization: Bearer $EMAILIT_API_KEY"
```

  Si une adresse a des blocages de plusieurs types, utilisez l’ID `sup_` pour supprimer le bon.

  Pour modifier un blocage plutôt que de le supprimer, par exemple pour ajouter une date d’expiration, appelez [Mettre à jour un blocage](/fr/docs/api-reference/suppressions/update/) avec `type`, `reason` ou `keep_until`. Définissez `keep_until` sur `null` pour retirer la date d’expiration.

## Configurer le blocage automatique

Emailit ajoute automatiquement à la liste les adresses qui rebondissent ou font l’objet d’une plainte. Sur Pro et Business, les administrateurs peuvent modifier ce comportement.

1. **Ouvrez les paramètres.** Accédez à **Workspace → Settings** et sélectionnez l’onglet **Suppressions**.

2. **Activez-le ou désactivez-le.** Utilisez **Enable automatic suppression**.

3. **Choisissez ce qu’il faut bloquer.** Dans **Suppress on**, choisissez **Bounces and Complaints** (par défaut), **Bounces only** ou **Complaints only**.

Sur les forfaits Pay as you go et Custom, le blocage automatique est toujours activé pour les rebonds et les plaintes. Les commandes affichent un badge **Pro** et ne peuvent pas être modifiées. Les membres qui ne sont pas administrateurs peuvent consulter les paramètres, mais pas les modifier. Pour savoir précisément quand Emailit bloque une adresse, consultez [Rebonds et plaintes](/fr/docs/deliverability/bounces-and-complaints/#automatic-suppression).

## Relancer les e-mails bloqués

Un message arrêté par un blocage reste `suppressed`, même après la suppression du blocage. Pour l’envoyer :

1. **Supprimez le blocage** de l’adresse, comme décrit ci-dessus. Sinon, la relance est bloquée elle aussi.

2. **Relancez l’e-mail.** Ouvrez-le dans **Email API → Emails** et sélectionnez **Retry**, ou appelez [Relancer un e-mail](/fr/docs/api-reference/emails/retry/).

Une relance crée un nouvel e-mail avec le même contenu et un nouvel ID, et coûte des crédits comme tout autre envoi. Vous pouvez relancer des e-mails datant de 30 jours au plus, tant que leur contenu est encore dans votre durée de [conservation des données](/fr/docs/data-retention/).

## Voir aussi

  - [Adresses bloquées](/fr/docs/suppressions/): Types, blocage automatique et expiration.
  - [Rebonds et plaintes](/fr/docs/deliverability/bounces-and-complaints/): Quand Emailit bloque une adresse.
  - [API des adresses bloquées](/fr/docs/api-reference/suppressions/): Tous les endpoints des adresses bloquées.
  - [Vérification d’e-mails](/fr/docs/email-verification/): Retirez les mauvaises adresses avant d’envoyer.

---
Source: https://emailit.com/fr/docs/suppressions/manage/