Count the mail in each folder
What the sidebar of the app shows, for every folder, label and address.
Runs the real call on your workspace.
GET /threads/counts
What the sidebar of the app shows, for every folder, label and address.
Example
Needs threads:read. folders has a row for inbox, sent, spam, archive, trash and snoozed, each with how many conversations it holds and how many of them are unread, then draft, whose count is the drafts waiting to be sent, then unread, whose count is the unread conversations in the inbox. labels has a row for each of your labels and each folder it has conversations in. addresses counts the inbox conversations that arrived at each address, with null for mail that recorded none.
curl "$OE/threads/[email protected]" -H "$AUTH"{ "object": "mailbox_counts", "folders": [ { "label": "inbox", "count": 412, "unread": 9 }, { "label": "sent", "count": 188, "unread": 0 }, { "label": "spam", "count": 3, "unread": 3 }, { "label": "archive", "count": 1270, "unread": 0 }, { "label": "trash", "count": 41, "unread": 1 }, { "label": "snoozed", "count": 2, "unread": 0 }, { "label": "draft", "count": 4, "unread": 0 }, { "label": "unread", "count": 9, "unread": 9 } ], "addresses": [{ "address": "[email protected]", "count": 412 }], "labels": [{ "id": "USER_CLIENTS", "folder": "inbox", "count": 23, "unread": 2 }], "categories": [ { "category": "primary", "count": 301, "unread": 6 }, { "category": "promotions", "count": 64, "unread": 2 }, { "category": "updates", "count": 38, "unread": 1 }, { "category": "social", "count": 5, "unread": 0 }, { "category": "forums", "count": 4, "unread": 0 } ], "unlabelled": { "count": 389, "unread": 7, "categories": [ { "category": "primary", "count": 278, "unread": 4 }, { "category": "promotions", "count": 64, "unread": 2 }, { "category": "updates", "count": 38, "unread": 1 }, { "category": "social", "count": 5, "unread": 0 }, { "category": "forums", "count": 4, "unread": 0 } ] }, "team": { "assigned": { "count": 6, "unread": 1 }, "unassigned": { "count": 14, "unread": 3 }, "mentions": { "count": 5, "unread": 1, "unseen": 2 } }}A key or an app limited to particular addresses counts only the mail that arrived at them and the drafts written from them. address narrows every count to one address, and an address outside what the key reaches counts nothing rather than failing.
categories has a row for each inbox tab, primary, promotions, updates, social and forums, counting inbox conversations only. primary is everything not sorted into another tab, so the five counts add up to the inbox.
unlabelled counts the inbox conversations that carry none of your labels, in total and for each tab. It is what the inbox of the app lists unless Labelled mail is ticked in its Filters menu, and a conversation labelled BOUNCED counts as labelled.
team counts the team views for the person the key or app acts for. assigned and unassigned are the open conversations assigned to them and the ones nobody has, and mentions the conversations a team comment mentions them in, with unseen for those with a mention newer than the last time they opened its comments in the app.