Microsoft Graph email list profile

org.intentschema.communication.email.message.list.v1@com.microsoft.graph.v1

JSON: bare · @sha256:ebb28ffb9a25…
Hash: sha256:ebb28ffb9a253532a3a97113d828d86dfc887c115105a54bbbbb9cf97e09bbb1

Graph profile for email list.

Implements: List email messages (org.intentschema.communication.email.message.list.v1)

Payload

FieldTypeDescription
target *Target(system = "ms_graph", required: system)
objectobject
object
FieldTypeDescription
querystringProvider-specific search string (Gmail syntax, JMAP filter string, Outlook KQL). Applied alongside `filter` if both are provided.
filterobjectStructured filter, JMAP-inspired.
limitinteger (minimum 1; maximum 500; default 50)
cursorstringOpaque pagination cursor returned by a prior search.
filter
FieldTypeDescription
fromstring
tostring
subjectstring
bodystring
has_attachmentboolean
is_unreadboolean
afterstring (date-time)
beforestring (date-time)
labels_anystring[]
labels_allstring[]

Result

FieldTypeDescription
messages *object[]
next_cursorstringPresent when more results are available.
estimated_totalintegerOptional provider estimate of total matches.

API mapping

FieldValue
base_urlhttps://graph.microsoft.com
methodGET
path/v1.0/me/messages
scopesMail.Read
docshttps://learn.microsoft.com/en-us/graph/api/user-list-messages

Field mapping

Intent fieldAPI parameter
object.query$search query param
object.filter.*$filter OData expression
object.limit$top
object.cursor$skip or @odata.nextLink