email_received

email_received is emitted after inbound email reaches a Broodnet mailbox. Subscribe at organization scope for every mailbox, or at mailbox scope for one inbox.

The event is a notification, not the message itself. Read the message and its body through IMAP or the Broodnet CLI after receiving the webhook.

Event data

Field	Type	Description
from	string	Sender address reported by the mail server
subject	string, optional	Message subject when available
size	number, optional	Message size in bytes when available

The envelope’s mailbox object identifies the destination mailbox. The actor is the mail system that recorded the inbound delivery.

Example

{
  "id": "audit-event-id",
  "type": "email_received",
  "occurredAt": "2026-07-18T10: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": "system",
    "id": "dovecot",
    "name": "Dovecot",
    "email": null,
    "address": null
  },
  "data": {
    "from": "customer@example.com",
    "subject": "Account access"
  }
}

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