# Eventos de supressão

> Supressões criadas, atualizadas ou excluídas.



## suppression.created

> Enviado quando você adiciona um endereço à lista de supressão pela API, por uma importação de CSV ou por uma etapa de automação.

# suppression.created

Enviado quando uma supressão é adicionada com [Criar uma supressão](/pt/docs/api-reference/suppressions/create/), por uma importação de CSV no painel ou pela etapa **Add to suppressions** de uma automação. As supressões que o Emailit adiciona automaticamente após bounces e reclamações não enviam este evento; escute [`email.bounced`](/pt/docs/webhooks/events/email/bounced/) e [`email.complained`](/pt/docs/webhooks/events/email/complained/) no lugar dele.

As requisições de webhook trazem um array JSON de eventos como este; consulte [Requisições de webhook](/pt/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
    }
  }
}
```

## Campos

- `event_id` (string): ID do evento (`evt_…`). Uma nova tentativa da requisição traz o mesmo ID, então use-o para ignorar eventos que você já processou. Você também pode consultar o evento com [Obter um evento](/pt/docs/api-reference/events/get/).

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

- `object` (object): A supressão que o evento descreve. Os campos dela estão listados abaixo.

- `data.object` (object): O mesmo objeto de novo, no formato que a [API de eventos](/pt/docs/api-reference/events/get/) retorna em `data`.

### Objeto de supressão

- `id` (string): ID da supressão (`sup_…`).

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

- `email` (string): Endereço suprimido, em minúsculas.

- `type` (string): `recipient`, `bounce`, `complaint` ou `unsubscribe`. Apenas as supressões `recipient` bloqueiam envios pela API e por SMTP; as campanhas excluem endereços com qualquer tipo de supressão.

- `reason` (string | null): Motivo da supressão.

- `created_at` (string): Quando a supressão foi criada, em ISO 8601 com deslocamento UTC.

- `keep_until` (string | null): Quando a supressão expira, ou `null` se ela for permanente.

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

## suppression.updated

> Enviado quando uma supressão muda, por exemplo o tipo, o motivo ou a data de expiração dela. Inclui a supressão atualizada.

# suppression.updated

Enviado quando uma supressão muda com [Atualizar uma supressão](/pt/docs/api-reference/suppressions/update/).

As requisições de webhook trazem um array JSON de eventos como este; consulte [Requisições de webhook](/pt/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"
    }
  }
}
```

## Campos

- `event_id` (string): ID do evento (`evt_…`). Uma nova tentativa da requisição traz o mesmo ID, então use-o para ignorar eventos que você já processou. Você também pode consultar o evento com [Obter um evento](/pt/docs/api-reference/events/get/).

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

- `object` (object): A supressão que o evento descreve. Os campos dela estão listados abaixo.

- `data.object` (object): O mesmo objeto de novo, no formato que a [API de eventos](/pt/docs/api-reference/events/get/) retorna em `data`.

### Objeto de supressão

- `id` (string): ID da supressão (`sup_…`).

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

- `email` (string): Endereço suprimido, em minúsculas.

- `type` (string): `recipient`, `bounce`, `complaint` ou `unsubscribe`. Apenas as supressões `recipient` bloqueiam envios pela API e por SMTP; as campanhas excluem endereços com qualquer tipo de supressão.

- `reason` (string | null): Motivo da supressão.

- `created_at` (string): Quando a supressão foi criada, em ISO 8601 com deslocamento UTC.

- `keep_until` (string | null): Quando a supressão expira, ou `null` se ela for permanente.

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

## suppression.deleted

> Enviado quando você exclui uma supressão para que o endereço possa voltar a receber e-mails. O payload é a supressão excluída.

# suppression.deleted

Enviado quando uma supressão é excluída com [Excluir uma supressão](/pt/docs/api-reference/suppressions/delete/). Uma supressão expirada continua na lista e não envia este evento, assim como a etapa **Remove from suppressions** de uma automação.

As requisições de webhook trazem um array JSON de eventos como este; consulte [Requisições de webhook](/pt/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
    }
  }
}
```

## Campos

- `event_id` (string): ID do evento (`evt_…`). Uma nova tentativa da requisição traz o mesmo ID, então use-o para ignorar eventos que você já processou. Você também pode consultar o evento com [Obter um evento](/pt/docs/api-reference/events/get/).

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

- `object` (object): A supressão que o evento descreve. Os campos dela estão listados abaixo.

- `data.object` (object): O mesmo objeto de novo, no formato que a [API de eventos](/pt/docs/api-reference/events/get/) retorna em `data`.

### Objeto de supressão

- `id` (string): ID da supressão (`sup_…`).

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

- `email` (string): Endereço suprimido, em minúsculas.

- `type` (string): `recipient`, `bounce`, `complaint` ou `unsubscribe`. Apenas as supressões `recipient` bloqueiam envios pela API e por SMTP; as campanhas excluem endereços com qualquer tipo de supressão.

- `reason` (string | null): Motivo da supressão.

- `created_at` (string): Quando a supressão foi criada, em ISO 8601 com deslocamento UTC.

- `keep_until` (string | null): Quando a supressão expira, ou `null` se ela for permanente.

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