Unified events feed
Read-only window over the brand’s analytics events across domains (email, automation, trigger, inbound). Defaults to the last 7 days. Equality filters: recipientEmail, eventType, automationId, sendId (join back to /v1/analytics/sends?sendId=). Send-object facets — source (csv of send sources), audienceId (csv, ≤20), emailId (design), domain (sending domain), triggerEventId (csv, ≤10 — integration trigger-events resolved to their wired automations): when ANY facet is present the feed narrows to EMAIL events only and each row is enriched with sendSource + sendContext (plus triggerProvider/triggerTitle on integration/custom-triggered rows). Machine/bot-classified clicked rows are EXCLUDED by default (matching /v1/analytics/overview); pass includeMachineClicks=true to include the raw rows (audit/debug only). Cursor pagination — pass pagination.cursor back as ?cursor=; loop while (cursor !== null). Requires the emails scope.
Authorizations
Send your Brew API key as Authorization: Bearer brew_xxx.
Query Parameters
1 - 641 - 641 - 64Send-object facet: CSV of send sources (valid values: audience, api, automation_manual, automation_integration, automation_custom). Narrows the feed to email events.
1 - 256Send-object facet: CSV of audience ids (max 20) — events from the audiences' sends. Narrows the feed to email events.
1 - 2048Send-object facet: one email design id. Narrows the feed to email events.
1 - 64Send-object facet: a sending domain (fromEmail match). Narrows the feed to email events.
1 - 255Send-object facet: CSV of integration trigger-event ids (max 10), resolved to their wired automations. Narrows the feed to email events.
1 - 2048Machine/bot-classified clicked rows are excluded by default. Pass true to include the raw rows (they carry machineGenerated: true + a clickBotReason; audit/debug only).
1 <= x <= 1001 - 8192