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

# IAM and Permission Groups

This page applies only to organizations that currently have permission groups. An organization sees its groups and their members in Mission Control Portal under Organizations, described in [Get Started with Organizations](https://support.telnyx.com/en/articles/1189141-get-started-with-organizations), or lists every user with their groups through [`GET /v2/organizations/users/users_groups_report`](https://developers.telnyx.com/api-reference/organization-users/get-organization-users-groups-report). An organization without groups can skip this page.

> [!CAUTION]
>
> Enabling IAM before the roles and grants exist locks out every user and service account without a grant.

Permission groups are the legacy access control in Mission Control Portal. Telnyx will not deprecate this legacy system at this time.

> [!WARNING]
>
> IAM is the recommended system for all organizations, and mixing these two systems is strongly discouraged.

## Going Forward

An organization that has permission groups keeps them, and nothing changes on the day IAM is made available. Before it enables IAM, its groups need to exist as [roles](https://developers.telnyx.com/docs/iam/access/roles.md) and [grants](https://developers.telnyx.com/docs/iam/access/grants.md), and there are two ways there.

* The organization writes the roles and grants itself, from its groups.
* The organization waits for Telnyx to carry its groups over as roles and grants.<sup>Preview</sup>

In both cases, the organization [enables IAM](https://developers.telnyx.com/docs/iam/organization/enable-iam.md) when it is ready, and until then roles and grants decide nothing. After the switch, a change to who may do what is made in roles, and the groups keep applying to users until they retire.

Preview Permission groups retire with notice once every organization has its roles. Roles are then the only permissions. See [Migrate an Existing Organization](https://developers.telnyx.com/docs/iam/scenarios/existing-organization.md#retiring-permission-groups).
