Événements de blocage

Blocages créés, mis à jour ou supprimés.

suppression.created
suppression.updated
suppression.deleted

suppression.created

Envoyé lorsqu’un blocage est ajouté avec Créer un blocage, un import CSV dans le tableau de bord ou l’étape Add to suppressions d’une automatisation. Les blocages qu’Emailit ajoute automatiquement après des rebonds et des plaintes ne déclenchent pas cet événement ; écoutez plutôt email.bounced et email.complained.

Les requêtes de webhook contiennent un tableau JSON d’événements comme celui-ci ; consultez Requêtes de webhook.

Champs

event_idstring

ID de l’événement (evt_…). Une requête relancée porte le même ID : utilisez-le pour ignorer les événements déjà traités. Vous pouvez aussi consulter l’événement avec Récupérer un événement.

typestring

Toujours suppression.created.

objectobject

Le blocage décrit par l’événement. Ses champs sont détaillés ci-dessous.

data.objectobject

Le même objet, sous la forme que l’API des événements renvoie dans data.

Objet blocage

idstring

ID du blocage (sup_…).

objectstring

Toujours suppression.

emailstring

Adresse bloquée, en minuscules.

typestring

recipient, bounce, complaint ou unsubscribe. Seuls les blocages recipient arrêtent les envois via l’API et SMTP ; les campagnes excluent les adresses bloquées quel que soit le type.

reasonstring | null

Motif du blocage.

created_atstring

Date de création du blocage, au format ISO 8601 avec décalage UTC.

keep_untilstring | null

Date d’expiration du blocage, ou null s’il est permanent.

JSON

{
  "event_id": "evt_2xLc9Rr4Tn6Wb1Qm8Ks3Vf0Hd7a",
  "type": "suppression.created",
  "object": {
    "id": "sup_2xL1c8NqT4pWm6Rb0YsKd3HvF9e",
    "object": "suppression",
    "email": "ada@example.com",
    "type": "recipient",
    "reason": "manual",
    "created_at": "2026-10-01T09:30:12.481000+00:00",
    "keep_until": null
  },
  "data": {
    "object": {
      "id": "sup_2xL1c8NqT4pWm6Rb0YsKd3HvF9e",
      "object": "suppression",
      "email": "ada@example.com",
      "type": "recipient",
      "reason": "manual",
      "created_at": "2026-10-01T09:30:12.481000+00:00",
      "keep_until": null
    }
  }
}

suppression.updated

Envoyé lorsqu’un blocage est modifié avec Mettre à jour un blocage.

Les requêtes de webhook contiennent un tableau JSON d’événements comme celui-ci ; consultez Requêtes de webhook.

Champs

event_idstring

typestring

Toujours suppression.updated.

objectobject

Le blocage décrit par l’événement. Ses champs sont détaillés ci-dessous.

data.objectobject

Le même objet, sous la forme que l’API des événements renvoie dans data.

Objet blocage

idstring

ID du blocage (sup_…).

objectstring

Toujours suppression.

emailstring

Adresse bloquée, en minuscules.

typestring

recipient, bounce, complaint ou unsubscribe. Seuls les blocages recipient arrêtent les envois via l’API et SMTP ; les campagnes excluent les adresses bloquées quel que soit le type.

reasonstring | null

Motif du blocage.

created_atstring

Date de création du blocage, au format ISO 8601 avec décalage UTC.

keep_untilstring | null

Date d’expiration du blocage, ou null s’il est permanent.

JSON

{
  "event_id": "evt_2xLc9Rr4Tn6Wb1Qm8Ks3Vf0Hd7a",
  "type": "suppression.updated",
  "object": {
    "id": "sup_2xL1c8NqT4pWm6Rb0YsKd3HvF9e",
    "object": "suppression",
    "email": "ada@example.com",
    "type": "recipient",
    "reason": "Asked to pause invoices until January",
    "created_at": "2026-10-01T09:30:12.481000+00:00",
    "keep_until": "2027-01-01T00:00:00.000000+00:00"
  },
  "data": {
    "object": {
      "id": "sup_2xL1c8NqT4pWm6Rb0YsKd3HvF9e",
      "object": "suppression",
      "email": "ada@example.com",
      "type": "recipient",
      "reason": "Asked to pause invoices until January",
      "created_at": "2026-10-01T09:30:12.481000+00:00",
      "keep_until": "2027-01-01T00:00:00.000000+00:00"
    }
  }
}

suppression.deleted

Envoyé lorsqu’un blocage est supprimé avec Supprimer un blocage. Un blocage expiré reste dans la liste et ne déclenche pas cet événement, pas plus que l’étape Remove from suppressions d’une automatisation.

Les requêtes de webhook contiennent un tableau JSON d’événements comme celui-ci ; consultez Requêtes de webhook.

Champs

event_idstring

typestring

Toujours suppression.deleted.

objectobject

Le blocage décrit par l’événement. Ses champs sont détaillés ci-dessous.

data.objectobject

Le même objet, sous la forme que l’API des événements renvoie dans data.

Objet blocage

idstring

ID du blocage (sup_…).

objectstring

Toujours suppression.

emailstring

Adresse bloquée, en minuscules.

typestring

recipient, bounce, complaint ou unsubscribe. Seuls les blocages recipient arrêtent les envois via l’API et SMTP ; les campagnes excluent les adresses bloquées quel que soit le type.

reasonstring | null

Motif du blocage.

created_atstring

Date de création du blocage, au format ISO 8601 avec décalage UTC.

keep_untilstring | null

Date d’expiration du blocage, ou null s’il est permanent.

JSON

{
  "event_id": "evt_2xLc9Rr4Tn6Wb1Qm8Ks3Vf0Hd7a",
  "type": "suppression.deleted",
  "object": {
    "id": "sup_2xL1c8NqT4pWm6Rb0YsKd3HvF9e",
    "object": "suppression",
    "email": "ada@example.com",
    "type": "recipient",
    "reason": "manual",
    "created_at": "2026-10-01T09:30:12.481000+00:00",
    "keep_until": null
  },
  "data": {
    "object": {
      "id": "sup_2xL1c8NqT4pWm6Rb0YsKd3HvF9e",
      "object": "suppression",
      "email": "ada@example.com",
      "type": "recipient",
      "reason": "manual",
      "created_at": "2026-10-01T09:30:12.481000+00:00",
      "keep_until": null
    }
  }
}