outbound_consent_requested

outbound_consent_requested is emitted after Broodnet sends a consent request to an external recipient.

Organization endpoints receive every request. A mailbox endpoint receives the event only when that mailbox requested consent using mailbox-scoped credentials; requests created by an organization member have no mailbox association.

Event data

Field	Type	Description
email	string	External recipient asked to grant consent
note	string or null, optional	Note included with the consent request

The actor identifies the organization member or mailbox that requested consent. The envelope’s mailbox object is populated for mailbox-originated requests and null for organization-level requests.

Example

{
  "id": "audit-event-id",
  "type": "outbound_consent_requested",
  "occurredAt": "2026-07-18T12: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": "mailbox",
    "id": "mailbox-id",
    "name": "Support",
    "email": null,
    "address": "support@acme.broodnet.com"
  },
  "data": {
    "email": "customer@example.com",
    "note": "Permission for support follow-ups"
  }
}

See Outbound policy for the recipient-consent flow and the webhook overview for delivery behavior.