Outlook List Messages

• topinteger
  Maximum number of messages to return per request (1-1000). Always check response['@odata.nextLink'] for pagination. If present, make additional requests with that URL (includes $skiptoken). Repeat until '@odata.nextLink' is absent. For large mailboxes (1000+ messages), always pa…
• skipinteger
  Number of messages to skip from the beginning of the result set, for pagination.
• folderstring
  ID or well-known name of the mail folder. Well-known names (case-insensitive): archive, clutter, conflicts, conversationhistory, deleteditems, drafts, inbox, junkemail, localfailures, msgfolderroot, outbox, recoverableitemsdeletions, scheduled, searchfolders, sentitems, serverfa…
• searchstring
  Full-text search query using Microsoft Graph $search syntax. Searches across subject, body, and sender fields server-side. Cannot be combined with $filter or $orderby. Example: 'budget report' or 'from:john@example.com'
• selectarray
  Message properties to include. Accepts a list of strings or a comma-separated string (e.g., 'id,subject,from'). Valid properties: id, subject, from, toRecipients, ccRecipients, bccRecipients, receivedDateTime, sentDateTime, hasAttachments, importance, isRead, body, bodyPreview,…
• is_readboolean
  Filter by read status: 'true' for read, 'false' for unread. Unspecified means no filter by read status.
• orderbyarray
  Properties to sort results by, with direction. Accepts a list of strings or a comma-separated string. Each item should be like 'receivedDateTime desc' or 'subject asc'. Default is 'receivedDateTime desc'. Cannot be used with sentDateTime filters in Sent folder.
• subjectstring
  Filter by exact match of the subject line. Special characters like apostrophes, brackets will be automatically escaped. For complex subject searches, consider using 'Search Messages' instead.
• user_idstring
  Target user's email or 'me' for authenticated user. For delegated access, use shared mailbox or delegated user's email.
• categoriesarray
  Filter by categories (case-sensitive); matches if tagged with any specified category.
• importancestring
  Filter by importance: 'low', 'normal', or 'high'.
• from_addressstring
  Filter by the sender's exact email address. NOTE: This filter is applied client-side on the returned results, not server-side.

• data

  Required
  Data from the action execution
• errorstring
  Error if any occurred during the execution of the action
• successfulboolean

  Required
  Whether or not the action execution was successful or not

No verified related use cases are linked yet.

No published Skills explicitly reference this Action yet.