Unitalk Microsoft Outlook icon

Unitalk Microsoft Outlook

Consume Microsoft Outlook API

Actions37

Contact → Get Many

AI-generated

Summary

Retrieve multiple contacts from Microsoft Outlook with options to return all or limit the number of contacts, filter by query or email address, and choose the output format and included fields.

Inputs

  • Return All — Boolean to decide whether to return all matching contacts or limit the number returned.
  • Limit — Maximum number of contacts to return when Return All is false (minimum 1, default 50).
  • Output — Format of the returned contacts: Simplified (default), Raw, or Select Included Fields.
  • Fields — When Output is 'Select Included Fields', specifies which contact fields to include in the output.
  • Filters — Optional filters including a custom OData filter query and/or an email address (supports multiple comma-separated values) to restrict the contacts retrieved.

Output shape

a list of contact objects

The returned data shape depends on the 'Output' option selected. If 'Return All' is true, all matching contacts are returned; otherwise, the number is capped by 'Limit'. Filters are applied if specified. Errors during API calls are surfaced per item.

Examples

Example 1: Return up to 50 simplified contacts with no filters.

Return All false, Limit 50, Output Simplified.

Example 2: Return all contacts including only specific fields such as 'displayName' and 'emailAddresses'.

Return All true, Output Select Included Fields, Fields set to displayName and emailAddresses.

Example 3: Return contacts filtered by a custom OData query, limiting results to 10, in raw format.

Return All false, Limit 10, Output Raw, Filters with custom filter query.

Links

Discussion