List groups

GET {{baseUrl}}/api/v1/groups

This API lists a particular number of groups, based on the limit defined.

OAuth Scope

  • Desk.contacts.READ
  • Desk.settings.READ

Request Params

KeyDatatypeRequiredDescription
fromstringIndex number, starting from which the groups must be fetched. The default value is 1.
limitstringNumber of groups to list. The default value and the maximum value allowed is 50.
sortBystringKey that sorts the list of groups by a particular attribute: -(createdTime, modifiedTime, name, or count)
searchBystringSearch keyword to use for finding a particular group The keyword must contain at least two characters. Three types of search are supported: keyword* (search for values that start with the keyword, *keyword* (search for values that contain the keyword), and keyword (search for values that are exact matches of the keyword).
helpCenterIdstringID of the help center from which the resource must be fetched

HEADERS

KeyDatatypeRequiredDescription
Authorizationstring

RESPONSES

status: OK

{"data":[{"modifiedTime":"2017-09-19T04:58:50.000Z","creator":{"photoURL":"https://desk.zoho.com/portal/api/user/310975130121/photo?orgId=143315","name":"SupportAdmin","id":"310975130121"},"modifier":{"photoURL":"https://desk.zoho.com/portal/api/user/310975130121/photo?orgId=143315","name":"SupportAdmin","id":"310975130121"},"name":"Pro Customer","count":"353","description":"Pro Customers paid customers of the org will avail 24x7 Support service","createdTime":"2017-09-19T04:58:50.000Z","id":"310975130110","helpCenterId":"310975130119","logoUrl":"https://desk.zoho.com/portal/api/publicImages/310975130133?portalId=5c9470fcc808cc98932703e28221d6c302e105dc4da8b23fafb6719abeecaa48","status":"ACTIVE"}]}