Suppressions

La liste de suppression empêche l'envoi d'e-mails aux adresses qui ont rebondi, se sont désabonnées ou ont déposé des plaintes. MailLand gère les suppressions automatiquement à partir des événements de rebond et de plainte, et vous pouvez ajouter ou supprimer des entrées manuellement via l'API.

Types de suppressionCopier le lien de la section

Portées de suppressionCopier le lien de la section

Les portées contrôlent quels types d'e-mails sont bloqués :

Contraintes de portée :

• HardBounce, Complaint, Invalid, SpamTrap, RoleAddress → Portée Global uniquement
• SoftBounce → Portée Marketing en général
• Unsubscribe → Global, Marketing ou List (pas Transactional)
• Manual → N'importe quelle portée

Lister les suppressionsCopier le lien de la section

GET https://api.mail.land/v1/transactional/suppressions

Authentifiez-vous avec Authorization: Bearer <token> ou X-API-Key: <api key>.

curl https://api.mail.land/v1/transactional/suppressions \
  -H "Authorization: Bearer eyJhbGciOiJIUzI1NiIs..."

Paramètres de requêteCopier le lien de la section

{
  "items": [
    {
      "id": "k3v9x2m8q1w7z4",
      "email": "[email protected]",
      "suppressionType": "hardBounce",
      "scope": "global",
      "mailingListId": null,
      "mailingListName": null,
      "expiresAt": null,
      "reason": "550 5.1.1 The email account does not exist",
      "bounceType": "Hard",
      "bounceCategory": "invalid_recipient",
      "bounceCount": 1,
      "lastBounceAt": "2026-02-17T12:00:00Z",
      "unsubscribeSource": null,
      "campaignId": null,
      "subscriberId": null,
      "source": "webhook",
      "notes": null,
      "createdAt": "2026-02-17T12:00:01Z",
      "isLocked": false,
      "lockedReason": null
    }
  ],
  "nextCursor": "eyJ2IjoxLCJzIjoiY3JlYXRlZGF0OmRlc2MiLCJrIjoi...",
  "hasMore": true
}

mailingListId, campaignId et subscriberId sont l'id public de la ressource associée, résolu dans votre tenant : jamais l'id numérique interne de la ligne. Chacun vaut null lorsque l'entrée n'a pas ce lien, ou lorsque la ressource associée a depuis été supprimée.

Statistiques de suppressionCopier le lien de la section

Obtenez un résumé de votre liste de suppression :

GET https://api.mail.land/v1/transactional/suppressions/stats

curl https://api.mail.land/v1/transactional/suppressions/stats \
  -H "Authorization: Bearer eyJhbGciOiJIUzI1NiIs..."

{
  "totalCount": 5000,
  "globalCount": 3000,
  "marketingCount": 1500,
  "transactionalCount": 200,
  "listCount": 300,
  "hardBounceCount": 2000,
  "softBounceCount": 1500,
  "complaintCount": 500,
  "unsubscribeCount": 700,
  "manualCount": 200,
  "invalidCount": 50,
  "spamTrapCount": 30,
  "roleAddressCount": 20,
  "expiringCount": 85,
  "lastSuppression": "2026-02-17T12:00:01Z"
}

expiringCount indique les rebonds temporaires qui expireront dans les 7 prochains jours.

Vérifier si un e-mail est suppriméCopier le lien de la section

Vérification individuelleCopier le lien de la section

GET https://api.mail.land/v1/transactional/suppressions/[email protected]&messageType=Marketing

curl "https://api.mail.land/v1/transactional/suppressions/[email protected]&messageType=Marketing" \
  -H "Authorization: Bearer eyJhbGciOiJIUzI1NiIs..."

{
  "email": "[email protected]",
  "isSuppressed": true,
  "messageType": "Marketing"
}

Vérification en lotCopier le lien de la section

Vérifiez jusqu'à 1 000 e-mails à la fois :

POST https://api.mail.land/v1/transactional/suppressions/check-bulk

curl -X POST https://api.mail.land/v1/transactional/suppressions/check-bulk \
  -H "Authorization: Bearer eyJhbGciOiJIUzI1NiIs..." \
  -H "Content-Type: application/json" \
  -d '{"emails":["[email protected]","[email protected]","[email protected]"],"messageType":"Marketing","mailingListId":null}'

{
  "emails": ["[email protected]", "[email protected]", "[email protected]"],
  "messageType": "Marketing",
  "mailingListId": null
}

{
  "suppressedEmails": ["[email protected]"]
}

Ajouter une suppressionCopier le lien de la section

POST https://api.mail.land/v1/transactional/suppressions

curl -X POST https://api.mail.land/v1/transactional/suppressions \
  -H "Authorization: Bearer eyJhbGciOiJIUzI1NiIs..." \
  -H "Content-Type: application/json" \
  -d '{"email":"[email protected]","suppressionType":"Manual","scope":"Global","reason":"Customer requested removal from all lists","notes":"Ticket #4521"}'

{
  "email": "[email protected]",
  "suppressionType": "Manual",
  "scope": "Global",
  "reason": "Customer requested removal from all lists",
  "notes": "Ticket #4521"
}

Retourne 201 Created avec l'objet de suppression complet. L'en-tête Location est /v1/transactional/suppressions : la route de liste, puisqu'il n'existe pas de route de récupération par id. Utilisez le champ id du corps pour identifier la suppression créée, et les sections « Lister les suppressions » ou « Vérifier si un e-mail est supprimé » ci-dessous pour la retrouver.

Ajout en lotCopier le lien de la section

Ajoutez jusqu'à 1 000 suppressions à la fois :

POST https://api.mail.land/v1/transactional/suppressions/bulk

curl -X POST https://api.mail.land/v1/transactional/suppressions/bulk \
  -H "Authorization: Bearer eyJhbGciOiJIUzI1NiIs..." \
  -H "Content-Type: application/json" \
  -d '{"emails":[{"email":"[email protected]","suppressionType":"Manual","scope":"Global","reason":"Cleanup"},{"email":"[email protected]","suppressionType":"Manual","scope":"Marketing"}]}'

{
  "emails": [
    { "email": "[email protected]", "suppressionType": "Manual", "scope": "Global", "reason": "Cleanup" },
    { "email": "[email protected]", "suppressionType": "Manual", "scope": "Marketing" }
  ]
}

{
  "totalCount": 2,
  "addedCount": 2,
  "skippedCount": 0,
  "skippedEmails": [],
  "message": "Added 2 suppressions"
}

Les e-mails déjà présents dans la liste de suppression sont ignorés (pas de doublons).

Importer depuis CSVCopier le lien de la section

Depuis du contenu texteCopier le lien de la section

POST https://api.mail.land/v1/transactional/suppressions/import

curl -X POST https://api.mail.land/v1/transactional/suppressions/import \
  -H "Authorization: Bearer eyJhbGciOiJIUzI1NiIs..." \
  -H "Content-Type: application/json" \
  -d '{"csvContent":"[email protected]\[email protected]\[email protected]","defaultReason":"Imported from legacy system","suppressionType":"Manual","scope":"Global"}'

{
  "csvContent": "[email protected]\n[email protected]\n[email protected]",
  "defaultReason": "Imported from legacy system",
  "suppressionType": "Manual",
  "scope": "Global"
}

Depuis un fichier téléverséCopier le lien de la section

POST https://api.mail.land/v1/transactional/suppressions/import-file

curl -X POST "https://api.mail.land/v1/transactional/suppressions/import-file?scope=List&mailingListId=123" \
  -H "Authorization: Bearer eyJhbGciOiJIUzI1NiIs..." \
  -F "[email protected]"

Téléversez un fichier .csv (max 5 Mo) avec des adresses e-mail séparées par des virgules ou des retours à la ligne. Une ligne d'en-tête contenant "email" est automatiquement ignorée.

Paramètres de requête :

{
  "totalRows": 1000,
  "importedCount": 950,
  "skippedCount": 40,
  "invalidCount": 10,
  "invalidEmails": ["not-an-email", "missing-domain@", "..."],
  "errors": [],
  "message": "Imported 950 emails. 40 already existed. 10 invalid."
}

Exporter les suppressionsCopier le lien de la section

Téléchargez votre liste de suppression au format CSV :

GET https://api.mail.land/v1/transactional/suppressions/export

curl https://api.mail.land/v1/transactional/suppressions/export \
  -H "Authorization: Bearer eyJhbGciOiJIUzI1NiIs..." \
  -o suppressions.csv

Retourne un fichier CSV avec les colonnes : email, type, scope, mailing_list, reason, bounce_count, source, created_at, expires_at. Limité à 100 000 lignes.

Supprimer une suppressionCopier le lien de la section

Par IDCopier le lien de la section

DELETE https://api.mail.land/v1/transactional/suppressions/{id}

curl -X DELETE https://api.mail.land/v1/transactional/suppressions/k3v9x2m8q1w7z4 \
  -H "Authorization: Bearer eyJhbGciOiJIUzI1NiIs..."

Par e-mailCopier le lien de la section

DELETE https://api.mail.land/v1/transactional/suppressions/[email protected]

curl -X DELETE "https://api.mail.land/v1/transactional/suppressions/[email protected]" \
  -H "Authorization: Bearer eyJhbGciOiJIUzI1NiIs..."

Retourne 204 No Content en cas de succès, 404 si introuvable.

Suppressions verrouilléesCopier le lien de la section

Certaines suppressions ne peuvent pas être supprimées pour protéger votre réputation d'expéditeur et respecter les réglementations anti-spam :

Tenter de supprimer une suppression verrouillée retourne :

{
  "code": "SUPPRESSION_LOCKED",
  "message": "Cannot delete: Spam complaint - compliance requirement",
  "details": {
    "lockedReason": "Spam complaint - compliance requirement"
  }
}

Sources de désabonnementCopier le lien de la section

Lorsqu'un destinataire se désabonne, la source est enregistrée :

Réponses d'erreurCopier le lien de la section

Prochaines étapesCopier le lien de la section

• Rebonds : comprendre les types de rebonds et la suppression automatique
• Vue d'ensemble de la délivrabilité : surveiller la réputation de l'expéditeur
• Événements Webhook : recevoir les événements message.bounced (suppression.added/suppression.removed sont définis dans le catalogue mais ne sont jamais émis aujourd'hui)