Unitalk Microsoft Outlook icon

Unitalk Microsoft Outlook

Consume Microsoft Outlook API

Actions37

Folder → Get Many

AI-generated

Summary

Retrieve multiple Outlook mail folders with optional filters, field selection, and parent folder specification.

Inputs

  • Return All — Whether to return all matching mail folders or limit the number of results.
  • Limit — The maximum number of mail folders to return when 'Return All' is false; minimum 1, default 50.
  • Filters — A filter query string to apply to the folders, supporting Microsoft Graph filter syntax (e.g., filtering by folder display name).
  • Fields — Specific folder fields to include in the output, such as child folder count, display name, hidden status, parent folder ID, total item count, and unread item count.
  • Include Child Folders — Option to include subfolders recursively in the results.
  • Parent Folder — Folder ID or link specifying the parent folder under which to search for folders; can be selected from a list, provided as URL, or as a folder ID string.

Output shape

a list of folder objects

The output includes mail folders matching the optional filter and parent folder criteria, constrained by limit or 'Return All' selection. Output fields vary based on user selection. Pagination or recursive inclusion applies if enabled.

Examples

Example 1: List up to 50 folder objects under default mailbox root without filters or child folders.

Return All: false, Limit: 50, no filters, no parent folder specified.

Example 2: Retrieve all folders including child folders filtering by display name.

Return All: true, Filters: displayName eq 'My Folder', Include Child Folders: true.

Links

Discussion