email_blocked

email_blocked is emitted when an outbound message is refused by Broodnet’s policy. Subscribe at organization scope for every mailbox, or at mailbox scope for one sender.

Use this event to alert an operator, explain a failed agent action, or route the attempt for policy review. It does not contain the message subject or body.

Event data

Field	Type	Description
sender	string	Broodnet mailbox address that attempted to send
recipient	string	Refused recipient address
reason	string	Machine-readable or diagnostic policy reason

The envelope’s mailbox object identifies the sending mailbox.

Example

{
  "id": "audit-event-id",
  "type": "email_blocked",
  "occurredAt": "2026-07-18T10:06: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": "postfix-policy-daemon",
    "name": "Postfix policy daemon",
    "email": null,
    "address": null
  },
  "data": {
    "sender": "support@acme.broodnet.com",
    "recipient": "unknown@example.net",
    "reason": "outbound_policy_violation"
  }
}

See Outbound policy for the allowed recipient rules and the webhook overview for delivery behavior.