# Eventi delle soppressioni

> Soppressioni create, aggiornate o eliminate.



## suppression.created

> Inviato quando aggiungi un indirizzo alla lista di soppressione tramite l’API, un’importazione CSV o un passaggio di un’automazione.

# suppression.created

Inviato quando viene aggiunta una soppressione con [Crea una soppressione](/it/docs/api-reference/suppressions/create/), 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`](/it/docs/webhooks/events/email/bounced/) e [`email.complained`](/it/docs/webhooks/events/email/complained/).

Le richieste webhook contengono un array JSON di eventi come questo; vedi [Richieste webhook](/it/docs/webhooks/webhook-requests/).

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

## Campi

- `event_id` (string): 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](/it/docs/api-reference/events/get/).

- `type` (string): Sempre `suppression.created`.

- `object` (object): La soppressione descritta dall’evento. I suoi campi sono elencati qui sotto.

- `data.object` (object): Di nuovo lo stesso oggetto, nella forma in cui l’[API degli eventi](/it/docs/api-reference/events/get/) lo restituisce in `data`.

### Oggetto soppressione

- `id` (string): ID della soppressione (`sup_…`).

- `object` (string): Sempre `suppression`.

- `email` (string): Indirizzo soppresso, in minuscolo.

- `type` (string): `recipient`, `bounce`, `complaint` o `unsubscribe`. Solo le soppressioni `recipient` bloccano gli invii tramite API e SMTP; le campagne saltano tutti i tipi.

- `reason` (string | null): Motivo della soppressione.

- `created_at` (string): Quando è stata creata la soppressione, in formato ISO 8601 con offset UTC.

- `keep_until` (string | null): Quando scade la soppressione, oppure `null` se è permanente.

---
Fonte: https://emailit.com/it/docs/webhooks/events/suppression/suppression-created/

## suppression.updated

> Inviato quando una soppressione cambia, ad esempio il tipo, il motivo o la data di scadenza. Include la soppressione aggiornata.

# suppression.updated

Inviato quando una soppressione viene modificata con [Aggiorna una soppressione](/it/docs/api-reference/suppressions/update/).

Le richieste webhook contengono un array JSON di eventi come questo; vedi [Richieste webhook](/it/docs/webhooks/webhook-requests/).

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

## Campi

- `event_id` (string): 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](/it/docs/api-reference/events/get/).

- `type` (string): Sempre `suppression.updated`.

- `object` (object): La soppressione descritta dall’evento. I suoi campi sono elencati qui sotto.

- `data.object` (object): Di nuovo lo stesso oggetto, nella forma in cui l’[API degli eventi](/it/docs/api-reference/events/get/) lo restituisce in `data`.

### Oggetto soppressione

- `id` (string): ID della soppressione (`sup_…`).

- `object` (string): Sempre `suppression`.

- `email` (string): Indirizzo soppresso, in minuscolo.

- `type` (string): `recipient`, `bounce`, `complaint` o `unsubscribe`. Solo le soppressioni `recipient` bloccano gli invii tramite API e SMTP; le campagne saltano tutti i tipi.

- `reason` (string | null): Motivo della soppressione.

- `created_at` (string): Quando è stata creata la soppressione, in formato ISO 8601 con offset UTC.

- `keep_until` (string | null): Quando scade la soppressione, oppure `null` se è permanente.

---
Fonte: https://emailit.com/it/docs/webhooks/events/suppression/suppression-updated/

## suppression.deleted

> Inviato quando elimini una soppressione, così l’indirizzo può di nuovo ricevere email. Il payload è la soppressione eliminata.

# suppression.deleted

Inviato quando viene eliminata una soppressione con [Elimina una soppressione](/it/docs/api-reference/suppressions/delete/). 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](/it/docs/webhooks/webhook-requests/).

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

## Campi

- `event_id` (string): 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](/it/docs/api-reference/events/get/).

- `type` (string): Sempre `suppression.deleted`.

- `object` (object): La soppressione descritta dall’evento. I suoi campi sono elencati qui sotto.

- `data.object` (object): Di nuovo lo stesso oggetto, nella forma in cui l’[API degli eventi](/it/docs/api-reference/events/get/) lo restituisce in `data`.

### Oggetto soppressione

- `id` (string): ID della soppressione (`sup_…`).

- `object` (string): Sempre `suppression`.

- `email` (string): Indirizzo soppresso, in minuscolo.

- `type` (string): `recipient`, `bounce`, `complaint` o `unsubscribe`. Solo le soppressioni `recipient` bloccano gli invii tramite API e SMTP; le campagne saltano tutti i tipi.

- `reason` (string | null): Motivo della soppressione.

- `created_at` (string): Quando è stata creata la soppressione, in formato ISO 8601 con offset UTC.

- `keep_until` (string | null): Quando scade la soppressione, oppure `null` se è permanente.

---
Fonte: https://emailit.com/it/docs/webhooks/events/suppression/suppression-deleted/
