Skip to main content

List starred messages

GET 
/api/accounts/:accountId/flagged

Returns the account's starred (\Flagged) messages from every folder, newest first, up to limit messages. Each entry is a message header tagged with folder and folderName, matching the shape used by search results.

Every non-hidden folder is searched, including Trash, and folders under Virtual and the All Mail folder are skipped. The response has messages and total, where total is the number of messages returned after applying the limit. With filter=unread, only starred messages without the \Seen flag are returned.

Request​

Responses​

Starred messages.