> ## 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.

# Find Groups

List and query groups in a tenant.

Application permission required: `Directories | Groups | Edit`.

<Note>
  External Documentation

  To learn more, visit the [Mimecast documentation](https://developer.services.mimecast.com/docs/userandgroupmanagement/1/routes/api/directory/find-groups/post).
</Note>

## Parameters

<div className="integrations-table">
  | Parameter  | Description                                                           |
  | ---------- | --------------------------------------------------------------------- |
  | Page Size  | The number of results to request.                                     |
  | Page Token | The value of the 'next' or 'previous' fields from an earlier request. |
  | Query      | A string to query for.                                                |
  | Source     | A group source to filter on. `default_value: cloud`                   |
</div>

## Example Output

```json theme={"dark"}
{
  "meta": {
    "status": 200,
    "pagination": {
      "pageSize": 25,
      "recordStart": 0,
      "next": "eNqrVipOTS4tSs.....",
      "previous": "eNqrVipOTS4tSs....."
  },
  "data": [
    {
      "folders": [
        {
          "description": "String",
          "source": "String",
          "folderCount": 0,
          "parentId": "String",
          "id": "String",
          "userCount": 10
        }
      ],
      "source": "String",
      "query": "String"
    }
  ]
}
```

## Workflow Library Example

[Find Groups with Mimecast and Send Results Via Email](https://library.blinkops.com/workflows/find-groups-with-mimecast-and-send-results-via-email)

<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/find-groups-with-mimecast-and-send-results-via-email/canvas" />
</div>