Read how mail arrives
How mail arrives, as the Analytics page of the app shows it.
Runs the real call on your workspace.
GET /analytics/mailbox
How mail arrives, as the Analytics page of the app shows it.
Example
Needs threads:read. The window is the last 30 days unless from and to say otherwise, cut into days, or into hours or minutes with grain. Pass offsetMinutes, the reader’s minutes east of UTC, so a day breaks where theirs does.
curl "$OE/analytics/mailbox?offsetMinutes=120" -H "$AUTH"{ "object": "mailbox_insights", "from": "2026-09-02T09:00:00.000Z", "to": "2026-10-02T09:00:00.000Z", "grain": "day", "offsetMinutes": 120, "scanned": 486, "days": [ { "day": "2026-09-30", "count": 21 }, { "day": "2026-10-01", "count": 17 } ], "hours": [ { "hour": 9, "count": 64 }, { "hour": 14, "count": 51 } ], "addresses": [{ "address": "[email protected]", "count": 301 }], "senders": [ { "email": "[email protected]", "name": "Ada Lovelace", "count": 18, "lastAt": "2026-10-01T16:20:11.000Z" } ], "senderCount": 132, "waiting": [ { "band": 1, "count": 6 }, { "band": 3, "count": 2 }, { "band": 7, "count": 1 } ], "unattributed": 0, "folders": [{ "label": "inbox", "count": 412, "unread": 9 }], "series": []}scanned counts the conversations that arrived inside the window. days spreads them over the buckets and hours over the hours of the day, addresses counts them by the address they arrived at, and senders names the people who wrote most. waiting counts the conversations still waiting on a reply after 1, 3 and 7 days, and folders what each folder holds.
A key or an app limited to particular addresses counts only the mail that arrived at them. address narrows everything to one address, and an address outside what the key reaches counts nothing rather than failing.