GET - Get All Groups

Purpose

This API is used to retrieve details of all the groups where tasks have been added in the organization, providing details for each group such as its ID, name, owner, moderator, and number of members.

OAuth Scope

Use the scope

ZohoMail.tasks.ALL (or) ZohoMail.tasks.READ

to generate the Authtoken.

ALL - Full access to tasks.

READ - Retrieve all the groups.

Request URL

Method: GET

https://mail.zoho.com/api/tasks/groups

* - Mandatory parameter

Response Codes

Refer here for the response codes and their meaning.

Sample Request

Copiedcurl "https://mail.zoho.com/api/tasks/groups" \
-X GET \
-H "Accept: application/json" \
-H "Content-Type: application/json" \
-H "Authorization:Zoho-oauthtoken *****"

Sample Response

Copied{
  "status": {
    "code": 200,
    "description": "success"
  },
  "data": {
    "groups": [
      {
        "owner": "Rebecca",
        "numberOfMembers": 3,
        "name": "Marketing Discussions",
        "id": 53658048,
        "moderators": ["Rebecca"]
      },
      {
        "owner": "Michelle R",
        "numberOfMembers": 2,
        "name": "Sales Reports",
        "id": 53883694,
        "moderators": ["Michelle R"]
      }
    ]
  }
}