---
updatedAt: 2026-04-18T03:31:09.000Z
---

# Groups

The Groups API enables you to create and manage groups (Team Views) within Avaya Infinity™. Groups are identified by a unique 26-character group ID prefixed `007`.

For managing group membership, see the [Group Users API Reference](https://developers.avayacloud.com/avaya-infinity/reference/group-users).

## Endpoints

### List All Groups

`GET /groups`

Retrieve a paginated list of all active groups for the account. Supports filtering by date range using `updatedSince` and `updatedUntil` to retrieve groups that have changed within a specific window. Groups are considered updated when their properties change or when members are added, removed, or modified.

[View API Reference →](https://developers.avayacloud.com/avaya-infinity/reference/get_groups)

### Create a Group

`POST /groups`

Create a new group with optional initial members. If no members are specified, the authenticated user is automatically added as the first member.

[View API Reference →](https://developers.avayacloud.com/avaya-infinity/reference/post_groups)

### Get a Group

`GET /groups/{groupId}`

Retrieve a specific group by ID, including its full list of members. Use the `includeInDashboard` query parameter to filter the returned members by their team dashboard visibility setting.

[View API Reference →](https://developers.avayacloud.com/avaya-infinity/reference/get_groups-groupid)

### Update a Group

`PATCH /groups/{groupId}`

Update a group's properties and/or membership. At least one property must be provided. When updating members, the supplied list replaces all existing members.

[View API Reference →](https://developers.avayacloud.com/avaya-infinity/reference/patch_groups-groupid)

## Getting Started

Use the List All Groups endpoint to discover existing groups and their IDs. To set up a new group, call Create a Group with a name and optional initial members. Use Update a Group to modify properties or replace the full member list. To add members incrementally without affecting existing membership, use the [Group Users API](https://developers.avayacloud.com/avaya-infinity/reference/group-users).