mailbox_deleted

mailbox_deleted is emitted when a mailbox is deleted. It is delivered only to organization-scoped endpoints.

Mailbox-scoped endpoints are deleted with their mailbox, so they cannot receive this event. The payload preserves the mailbox’s final identity and address after the mailbox record is gone.

Event data

Field	Type	Description
mailboxId	string	ID of the deleted mailbox
localPart	string	Address portion before @
domain	string	Mailbox domain
reason	string, optional	Deletion reason when one is provided

The envelope’s mailbox object is a final snapshot of the deleted mailbox. The actor identifies who initiated deletion.

Example

{
  "id": "audit-event-id",
  "type": "mailbox_deleted",
  "occurredAt": "2026-07-18T11:00:00.000Z",
  "organization": {
    "id": "organization-id",
    "name": "Acme Agents",
    "slug": "acme-agents"
  },
  "mailbox": {
    "id": "mailbox-id",
    "name": "Legacy support",
    "address": "legacy@acme.broodnet.com",
    "localPart": "legacy",
    "domain": "acme.broodnet.com"
  },
  "actor": {
    "type": "user",
    "id": "user-id",
    "name": "Alex",
    "email": "alex@example.com",
    "address": null
  },
  "data": {
    "mailboxId": "mailbox-id",
    "localPart": "legacy",
    "domain": "acme.broodnet.com"
  }
}

See the webhook overview for signature verification, retries, and the common envelope.