Supported methods


The Flags resource allows you set to retrieve flags that indicate, among other things, if the message has been read.

GET: Message flags

/users/id/email_accounts/label/folders/folder/messages/message_id/flagstest it
idUnique id of a user accessible through your API key
labelThe label property of the email account instance. You can use 0 as an alias for the first email account of a user.
folderThe full folder path using / as the path hierarchy delimiter.
message_idUnique id of a message. This must be a email_message_id of an existing message in the thread.


delimiterstringIf / isn't fancy enough as a hierarchy delimiter when specifying the folder you want to obtain, you're free to use what you want, just make sure you set this delimiter parameter to tell us what you're using.

Response body

  "resource_url": stringFull URI of the resource,
  "flags": {
    "read": booleanwhether or not a message has been viewed,
    "answered": booleanwhether or not a message has been replied to,
    "flagged": booleanwhether or not a message has been flagged or marked important,
    "draft": booleanwhether or not a message is in draft mode

If you want to fetch headers, body and flags for a given message, you can use the related include_* GET parameters on the message instance to get them all in a single call.