Vai al contenuto
Docs

Soppressioni create, aggiornate o eliminate.

suppression.created

Inviato quando viene aggiunta una soppressione con Crea una soppressione, con un’importazione CSV nel pannello o con il passaggio Add to suppressions di un’automazione. Le soppressioni che Emailit aggiunge automaticamente dopo bounce e segnalazioni non generano questo evento; ascolta invece email.bounced e email.complained.

Le richieste webhook contengono un array JSON di eventi come questo; vedi Richieste webhook.

Campi

event_idstring

ID dell’evento (evt_…). Una richiesta ritentata contiene lo stesso ID: usalo per saltare gli eventi che hai già gestito. Puoi anche consultare l’evento con Recupera un evento.

typestring

Sempre suppression.created.

objectobject

La soppressione descritta dall’evento. I suoi campi sono elencati qui sotto.

data.objectobject

Di nuovo lo stesso oggetto, nella forma in cui l’API degli eventi lo restituisce in data.

Oggetto soppressione

idstring

ID della soppressione (sup_…).

objectstring

Sempre suppression.

emailstring

Indirizzo soppresso, in minuscolo.

typestring

recipient, bounce, complaint o unsubscribe. Solo le soppressioni recipient bloccano gli invii tramite API e SMTP; le campagne saltano tutti i tipi.

reasonstring | null

Motivo della soppressione.

created_atstring

Quando è stata creata la soppressione, in formato ISO 8601 con offset UTC.

keep_untilstring | null

Quando scade la soppressione, oppure null se è permanente.

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

Inviato quando una soppressione viene modificata con Aggiorna una soppressione.

Le richieste webhook contengono un array JSON di eventi come questo; vedi Richieste webhook.

Campi

event_idstring

ID dell’evento (evt_…). Una richiesta ritentata contiene lo stesso ID: usalo per saltare gli eventi che hai già gestito. Puoi anche consultare l’evento con Recupera un evento.

typestring

Sempre suppression.updated.

objectobject

La soppressione descritta dall’evento. I suoi campi sono elencati qui sotto.

data.objectobject

Di nuovo lo stesso oggetto, nella forma in cui l’API degli eventi lo restituisce in data.

Oggetto soppressione

idstring

ID della soppressione (sup_…).

objectstring

Sempre suppression.

emailstring

Indirizzo soppresso, in minuscolo.

typestring

recipient, bounce, complaint o unsubscribe. Solo le soppressioni recipient bloccano gli invii tramite API e SMTP; le campagne saltano tutti i tipi.

reasonstring | null

Motivo della soppressione.

created_atstring

Quando è stata creata la soppressione, in formato ISO 8601 con offset UTC.

keep_untilstring | null

Quando scade la soppressione, oppure null se è permanente.

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

Inviato quando viene eliminata una soppressione con Elimina una soppressione. Una soppressione scaduta resta nella lista e non genera questo evento, e non lo genera nemmeno il passaggio Remove from suppressions di un’automazione.

Le richieste webhook contengono un array JSON di eventi come questo; vedi Richieste webhook.

Campi

event_idstring

ID dell’evento (evt_…). Una richiesta ritentata contiene lo stesso ID: usalo per saltare gli eventi che hai già gestito. Puoi anche consultare l’evento con Recupera un evento.

typestring

Sempre suppression.deleted.

objectobject

La soppressione descritta dall’evento. I suoi campi sono elencati qui sotto.

data.objectobject

Di nuovo lo stesso oggetto, nella forma in cui l’API degli eventi lo restituisce in data.

Oggetto soppressione

idstring

ID della soppressione (sup_…).

objectstring

Sempre suppression.

emailstring

Indirizzo soppresso, in minuscolo.

typestring

recipient, bounce, complaint o unsubscribe. Solo le soppressioni recipient bloccano gli invii tramite API e SMTP; le campagne saltano tutti i tipi.

reasonstring | null

Motivo della soppressione.

created_atstring

Quando è stata creata la soppressione, in formato ISO 8601 con offset UTC.

keep_untilstring | null

Quando scade la soppressione, oppure null se è permanente.

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

Questa pagina ti è stata utile?

Grazie del feedback.

Grazie, leggiamo ogni messaggio.