> ## Documentation Index
> Fetch the complete documentation index at: https://developers.telnyx.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Groups

A group is everyone in one group of the organization's identity provider, such as the Okta group `voice-team`. A grant that names a group reaches each of its members, and membership changes in the identity provider change access with them.

> [!WARNING]
>
> **Preview.** Not available yet.

## Identity

Groups come from the identity provider the organization [connects](https://developers.telnyx.com/docs/iam/organization/identity-provider.md) in Mission Control Portal. A group is named `<provider>/<group>`, and the organization does not create or edit it in Telnyx.

## Grants

A grant names a group the way it names a user or a service account.

```json POST /v2/iam/grants theme={null}
{
  "role_id": "6d1a2c40-93d5-4b5e-9b8e-5e0f7b2a1c33",
  "principal_type": "group",
  "principal_id": "okta/voice-team"
}
```

A person in two groups holds the roles granted to both, and they add up like any other [grants](https://developers.telnyx.com/docs/iam/access/grants.md).

## Membership

Someone added to the group in the identity provider holds its roles, and someone removed from it loses them. With [SCIM provisioning](https://developers.telnyx.com/docs/iam/organization/identity-provider.md#scim), the change reaches Telnyx at once, open sessions included.
