suppression.created

Fired when a new suppression entry is created.

{
  "event_id": "evt_2bH7kNwP5mQaV1sXgIdKe6pZr",
  "type": "suppression.created",
  "data": {
    "object": {
      "id": "sup_4yM2nTvR8oPcX3uZiKeLg7sB",
      "object": "suppression",
      "email": "unsubscribed@example.com",
      "type": "bounced",
      "reason": "Delivery bounced",
      "created_at": "2025-12-24T09:00:00.000000Z",
      "keep_until": null
    }
  }
}

Fields

id string

Unique suppression identifier.

object string

Always suppression.

email string

Suppressed email address.

type string

Suppression type (e.g. bounced, complained, manual).

reason string

Reason for suppression.

created_at string

ISO 8601 timestamp.

keep_until string | null

ISO 8601 timestamp until suppression is kept.

suppression.updated

Fired when a suppression entry is updated.

{
  "event_id": "evt_2bH7kNwP5mQaV1sXgIdKe6pZr",
  "type": "suppression.updated",
  "data": {
    "object": {
      "id": "sup_4yM2nTvR8oPcX3uZiKeLg7sB",
      "object": "suppression",
      "email": "unsubscribed@example.com",
      "type": "bounced",
      "reason": "Delivery bounced",
      "keep_until": null,
      "created_at": "2025-12-24T09:00:00.000000Z"
    }
  }
}

Fields

id string

Unique suppression identifier.

object string

Always suppression.

email string

Suppressed email address.

type string

Suppression type (e.g. bounced, complained, manual).

reason string

Reason for suppression.

keep_until string | null

ISO 8601 timestamp until suppression is kept.

created_at string

ISO 8601 timestamp.

suppression.deleted

Fired when a suppression entry is removed.

{
  "event_id": "evt_2bH7kNwP5mQaV1sXgIdKe6pZr",
  "type": "suppression.deleted",
  "data": {
    "object": {
      "id": "sup_4yM2nTvR8oPcX3uZiKeLg7sB",
      "object": "suppression",
      "email": "unsubscribed@example.com",
      "type": "bounced",
      "reason": "Delivery bounced",
      "created_at": "2025-12-24T09:00:00.000000Z",
      "keep_until": null
    }
  }
}

Fields

id string

Unique suppression identifier.

object string

Always suppression.

email string

Suppressed email address.

type string

Suppression type (e.g. bounced, complained, manual).

reason string

Reason for suppression.

created_at string

ISO 8601 timestamp.

keep_until string | null

ISO 8601 timestamp until suppression is kept.