Skip to main content
Retrieve a list of user objects.
  • Least Privileged Microsoft Graph permission to access the action via App Registration: User.Read.All, User.ReadWrite.All.
  • Higher privileged Microsoft Graph permission to access the action via App Registration: Directory.Read.All, Directory.ReadWrite.All.
External DocumentationTo learn more, visit the Microsoft Teams documentation.

​
Parameters

ParameterDescription
LimitSpecify the number of users returned per page in the response. Valid range is 1-120.
Return All PagesAutomatically fetch all resources, page by page.

​
Example Output

{
	"@odata.context": "https://graph.microsoft.com/v1.0/$metadata#users",
	"value": [
		{
			"businessPhones": [],
			"displayName": "Conf Room Adams",
			"givenName": null,
			"jobTitle": null,
			"mail": "Adams@contoso.com",
			"mobilePhone": null,
			"officeLocation": null,
			"preferredLanguage": null,
			"surname": null,
			"userPrincipalName": "Adams@contoso.com",
			"id": "6ea91a8d-e32e-41a1-b7bd-d2d185eed0e0"
		},
		{
			"businessPhones": [
				"425-555-0100"
			],
			"displayName": "MOD Administrator",
			"givenName": "MOD",
			"jobTitle": null,
			"mail": null,
			"mobilePhone": "425-555-0101",
			"officeLocation": null,
			"preferredLanguage": "en-US",
			"surname": "Administrator",
			"userPrincipalName": "admin@contoso.com",
			"id": "4562bcc8-c436-4f95-b7c0-4f8ce89dca5e"
		}
	]
}

​
Workflow Library Example

List All Users with Microsoft Teams and Send Results Via Email
Workflow LibraryPreview this Workflow on desktop