> ## Documentation Index
> Fetch the complete documentation index at: https://docs.blinkops.com/llms.txt
> Use this file to discover all available pages before exploring further.

# List Groups

List all the groups available in an organization, excluding dynamic distribution groups.
**Optional** - when using the Filter by Group Name parameter, the output will be filtered to only the selected group by the given name.
For more information see [Microsoft's documentation](https://learn.microsoft.com/en-us/graph/api/resources/group?view=graph-rest-1.0).

* **Least privileged** Microsoft Graph permission to access the action via **application**: `GroupMember.Read.All`.
* **Higher privileged** Microsoft Graph permissions to access the action via **application**: `Directory.Read.All`, `Group.ReadWrite.All`, `GroupMember.ReadWrite.All`, `Group.Read.All`.

<Note>
  This action might have replication delays for groups that were recently created, updated, or deleted.
</Note>

<Note>
  External Documentation

  To learn more, visit the [Microsoft Entra ID documentation](https://learn.microsoft.com/en-us/graph/api/group-list?view=graph-rest-1.0\&tabs=http).
</Note>

## Parameters

<div className="integrations-table">
  | Parameter        | Description                                                                                                                                                                                                                                                                                                                                                                                                    |
  | ---------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
  | Filter           | The filter to apply on the operation. You can filter by display name, tag names, values etc. For example, to filter for a display name use displayName eq 'GroupName'. <br />For more information about group fields: [https://learn.microsoft.com/en-us/graph/api/resources/group?view=graph-rest-1.0#properties](https://learn.microsoft.com/en-us/graph/api/resources/group?view=graph-rest-1.0#properties) |
  | Limit            | Set the page size of the returned results.                                                                                                                                                                                                                                                                                                                                                                     |
  | Return All Pages | Automatically fetch all resources, page by page.                                                                                                                                                                                                                                                                                                                                                               |
</div>

## Example Output

```json theme={"dark"}
[
	{
		"id": "02b534c1-2d64-44f4-9f01-e6ea79065991",
		"deletedDateTime": null,
		"classification": null,
		"createdDateTime": "2022-12-20T15:00:49Z",
		"creationOptions": [
			"ProvisionGroupHomepage",
			"HubSiteId:00000000-0000-0000-0000-000000000000",
			"SPSiteLanguage:1033",
			"AllowFileSharingForGuestUsers"
		],
		"description": "<GROUP DESCRIPTION>",
		"displayName": "<GROUP NAME>",
		"expirationDateTime": null,
		"groupTypes": [
			"Unified"
		],
		"isAssignableToRole": null,
		"mail": "test@example.com",
		"mailEnabled": true,
		"mailNickname": "<NICKNAME>",
		"membershipRule": null,
		"membershipRuleProcessingState": null,
		"onPremisesDomainName": null,
		"onPremisesLastSyncDateTime": null,
		"onPremisesNetBiosName": null,
		"onPremisesSamAccountName": null,
		"onPremisesSecurityIdentifier": null,
		"onPremisesSyncEnabled": null,
		"preferredDataLocation": null,
		"preferredLanguage": null,
		"proxyAddresses": [
			"SPO:<SPO>",
			"SMTP:<SMTP>"
		],
		"renewedDateTime": "2022-12-20T15:00:49Z",
		"resourceBehaviorOptions": [],
		"resourceProvisioningOptions": [],
		"securityEnabled": false,
		"securityIdentifier": "example",
		"theme": null,
		"visibility": "Public",
		"onPremisesProvisioningErrors": []
	}
]
```

## Workflow Library Example

[Temporarily Add a User to a Group with Active Directory](https://library.blinkops.com/workflows/temporarily-add-a-user-to-a-group-with-active-directory)

<div className="iframe-wrapper">
  <div className="iframe-media">
    <img src="https://mintcdn.com/blinkops-2/ojHYuDeYX5FWuN8a/img/Icons/play-box.svg?fit=max&auto=format&n=ojHYuDeYX5FWuN8a&q=85&s=b8af968e71438a9499c3223c9bd29fb2" alt="Workflow Library" width="16" height="16" data-path="img/Icons/play-box.svg" />

    Preview this Workflow on desktop
  </div>

  <iframe className="iframe" src="https://library.blinkops.com/workflows/temporarily-add-a-user-to-a-group-with-active-directory/canvas" />
</div>