mailbox_created

mailbox_created is emitted when a new mailbox is created. It is available only to organization-scoped endpoints because a mailbox-scoped endpoint cannot exist before its mailbox.

Event data

Field	Type	Description
localPart	string	Address portion before @
domain	string	Mailbox domain

The envelope’s mailbox object contains the new mailbox identity, name, and full address. The actor identifies the user or agent that initiated creation.

Example

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

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