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

Retrieve a list of user groups in the organization.

Required scope for using this action:

* `Obtain user groups information`

<Note>
  External Documentation

  To learn more, visit the [Lark documentation](https://open.larksuite.com/document/server-docs/contact-v3/group/simplelist).
</Note>

## Parameters

<div className="integrations-table">
  | Parameter        | Description                                                                                                      |
  | ---------------- | ---------------------------------------------------------------------------------------------------------------- |
  | Page Size        | The number of groups to return per page (`1`-`200`).                                                             |
  | Page Token       | A token used for pagination. This value can be obtained from the `page_token` property from a previous response. |
  | Return All Pages | Automatically fetch all resources, page by page.                                                                 |
</div>

## Example Output

```json theme={"dark"}
{
	"code": 0,
	"msg": "success",
	"data": {
		"grouplist": [
			{
				"id": "g193821",
				"name": "IT outsourcing group",
				"description": "IT outsourcing group. Fine-grained permission control is required for this group.",
				"member_user_count": 2,
				"member_department_count": 0
			}
		],
		"page_token": "AQD9/Rn9556539ED40/dk53s4Ebp882DYfFaPFbz00L4CMZJrqGdzNyc8BcZtDbwVUvRmQTvyMYicnGWrde9X56TgdBuS+JDTJJDDPw=",
		"has_more": true
	}
}
```

## Workflow Library Example

[List Groups with Lark and Send Results Via Email](https://library.blinkops.com/workflows/list-groups-with-lark-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/list-groups-with-lark-and-send-results-via-email/canvas" />
</div>