Search Group Members

List the members of a group in Azure Active Directory.

Options

Field	Definition	Type	Required
Result Set	Choose one of the following options to display your search results: First Matching Record: returns a single user record First 900 Matching Records: returns the first 900 records that match the search criteria Stream Matching Records: pass all matching user records from your parent flow to a helper flow. A Streaming input section is added to the card from which you can select a helper flow for streaming and adding custom extensible fields.	Dropdown	TRUE
Search By	Choose the search operator when searching for groups: Exact Match returns groups whose properties are exactly equal to the input values. Starts With returns groups whose properties start with the input values. Query returns group members using Microsoft Graph query parameters. See Use query parameters to customize responses. parameters. Option is available only if Stream Matching Users is selected from the Result Set dropdown. For example, to query users whose city is Philadelphia and whose first name is John, use the query $filter = city eq 'Philadelphia' and displayName eq 'John'.	Dropdown	TRUE

Field

Definition

Type

Required

Result Set

Choose one of the following options to display your search results:

First Matching Record: returns a single user record
First 900 Matching Records: returns the first 900 records that match the search criteria
Stream Matching Records: pass all matching user records from your parent flow to a helper flow. A Streaming input section is added to the card from which you can select a helper flow for streaming and adding custom extensible fields.

Dropdown

TRUE

Search By

Choose the search operator when searching for groups:

Exact Match returns groups whose properties are exactly equal to the input values.

Starts With returns groups whose properties start with the input values.

Query returns group members using Microsoft Graph query parameters. See Use query parameters to customize responses. parameters. Option is available only if Stream Matching Users is selected from the Result Set dropdown.

For example, to query users whose city is Philadelphia and whose first name is John, use the query $filter = city eq 'Philadelphia' and displayName eq 'John'.

Dropdown

TRUE

To learn how to use the Stream Matching Records option and set up a helper flow to return a large number of records, see Stream matching records with a helper flow.

The input field properties shown for an Exact Match differ from the input field properties for Starts With.

An input value can't contain the # hash character.

Input

Field	Definition	Type	Required
User
Id or Username	User ID or username of the Office 365 user. This is the user's User Principal Name (UPN). A UPN is formed by taking the username and domain and combining them with the @ separator. For example, john.doe@somedomain.com. This could be the user's email address, but not always.	Text	TRUE

Field

Definition

Type

Required

User

Id or Username

User ID or username of the Office 365 user. This is the user's User Principal Name (UPN). A UPN is formed by taking the username and domain and combining them with the @ separator.

For example, john.doe@somedomain.com. This could be the user's email address, but not always.

Text

TRUE

Input

Field	Definition	Type	Required
Group
ID	Unique identifier for the group.	Text	TRUE
Search
Account Enabled	True if the account is enabled; otherwise, false.	Dropdown	FALSE
Age Group	Age group of the user. Allowed values: null, minor, Not Adult, and adult.	Dropdown	FALSE
City	City in which the user is located.	Text	FALSE
Consent Provided For Minor	Indicates if consent has been obtained for minors. Allowed values: null, granted, denied, and notRequired.	Text	FALSE
Country	Country or region in which the user is located. For example, US or UK.	Text	FALSE
Department	Name for the department in which the user works.	Text	FALSE
Display Name	The name displayed in the address book for the user. This is usually the combination of the user's first name, middle initial, and family name. The maximum length is 256 characters.	Text	FALSE
Employee Id	Employee identifier assigned to the user by the organization.	Text	FALSE
Given Name	Given name (first name) of the user.	Text	FALSE
Job Title	User's job title.	Text	FALSE
Mail	SMTP address for the user. For example, jeff@contoso.onmicrosoft.com.	Text	FALSE
Mail Nickname	Mail alias for the user.	Text	FALSE
On Premises Immutable ID	Property is used to associate an on-premises Active Directory user account to their Azure Active Directory user object. This property must be specified when creating a user account in the Graph if you're using a federated domain for the user's User Principal Name (UPN) property.	Text	FALSE
On Premises User Principal Name	Contains the on-premises User PrincipalName synchronized from the on-premises directory. The property is only populated for customers who are synchronizing their on-premises directory to Azure Active Directory using Azure Active Directory Connect.	Text	FALSE
State	State or province in the user's address.	Text	FALSE
Surname	User's surname (family name or last name).	Text	FALSE
Usage Location	A two letter country code defined by ISO 3166. This is required for assigning licenses to users, due to a legal requirement to check for availability of services in a country. For example, US, JP, and GB.	Text	FALSE
User Principal Name	User Principal Name (UPN) of the user. This is an internet-style login name for the user based on RFC 822. Its format is alias@domain, where the domain must be present in the tenant's collection of verified domains. This is sometimes the same as the user's email address.	Text	FALSE
User Type	A string value that can be used to classify user types in your directory, such as Member and Guest.	Dropdown	FALSE

Output

Field	Definition	Type
ID	The unique identifier for the user.	Text
Display Name	Name displayed in the address book for the user. This is usually the combination of the user's first name, middle initial, and family name.	Text
Mail	SMTP address for the user. For example, jeff@contoso.onmicrosoft.com.	Text
Account Enabled	true if the account is enabled; otherwise, false.	True/False
Age Group	Age group of the user. Allowed values: null, minor, Not Adult, and adult.	Text

Search Group Members

Options

Input

Input

Output

Related topics