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=). Cursor pagination — pass pagination.cursor back as ?cursor=; loop while (cursor !== null). Requires the emails scope.

GET /v1/analytics/events

Unified events feed

cURL

curl --request GET \
  --url https://brew.new/api/v1/analytics/events \
  --header 'Authorization: Bearer <token>'

200

{
  "data": [
    {
      "id": "evt_abc",
      "occurredAt": "2026-04-08T12:34:56.789Z",
      "domain": "email",
      "eventType": "opened",
      "recipientEmail": "[e-mail]",
      "sendId": "snd_8fK2mQ4p",
      "emailId": "eml_launch",
      "emailName": "Spring Launch"
    }
  ],
  "pagination": {
    "limit": 50,
    "cursor": null,
    "hasMore": false
  },
  "range": {
    "from": "2026-04-01T12:34:56.789Z",
    "to": "2026-04-08T12:34:56.789Z"
  }
}

Authorizations

bearerAuthapiKeyAuth

Authorization · string · header · default: Bearer brew_your_api_key · required

Send your Brew API key as Authorization: Bearer brew_xxx.

Query Parameters

from · string<date-time>

to · string<date-time>

recipientEmail · string<email>

eventType · string

Required string length: 1 - 64

automationId · string

Required string length: 1 - 64

sendId · string

Required string length: 1 - 64

limit · integer

Required range: 1 <= x <= 100

cursor · string

Required string length: 1 - 8192

Response

200

application/json

A page of unified analytics events.

data · object[] · required

Show child attributes

pagination · object · required

Show child attributes

range · object · required

Show child attributes