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

# Identity Provider

Single sign-on through an identity provider is optional, and IAM decides requests the same way with or without it. An organization that wants it sets it up in Mission Control Portal. With an identity provider connected, its groups become principals that grants can name, and, with SCIM, joiners and leavers are provisioned automatically.

> [!WARNING]
>
> **Preview.** Groups as principals and SCIM are not available yet. Single sign-on itself is configured in Mission Control Portal, outside the IAM API.

## Sign-In

The organization connects its identity provider in Mission Control Portal and chooses there whether sign-in through it is mandatory. The support site shows the setup for [Okta](https://support.telnyx.com/en/articles/5335562-okta-setting-up-okta-saml-identity-provider-with-telnyx) and other SAML providers. IAM decides a request the same way whether the user signed in with a password or through the identity provider.

## Groups

The identity provider's groups become [group principals](https://developers.telnyx.com/docs/iam/principals/groups.md), named `okta/voice-team` for the Okta group `voice-team`. A grant that names a group reaches each of its members, and moving someone between groups changes their access with it.

## SCIM

With SCIM, the identity provider creates and removes Telnyx users and keeps group membership in step, so nobody touches Telnyx when people join, move, or leave.

```json PATCH /v2/iam/settings theme={null}
{
  "scim": { "enabled": true }
}
```

```json Output theme={null}
{
  "scim": {
    "enabled": true,
    "base_url": "https://api.telnyx.com/v2/iam/scim",
    "token": "scim_tok_..."
  }
}
```

The response holds what to paste into the identity provider. Someone removed there loses Telnyx access at once, open sessions included, and a person who leaves a manager organization loses access to every [managed organization](https://developers.telnyx.com/docs/iam/access/delegations.md) at the same moment.
