# Okta SCIM directory sync

<!-- Generated by scripts/generate.ts. Do not edit. -->

Turn on SCIM provisioning for your Okta app integration, connect it with the URL and token from this setup, and choose what Okta pushes.

:::caution[Verification]
Not yet verified on a real Okta tenant. It was written from the public Okta documentation, so labels in the admin console may differ slightly.
:::

The values in braces, such as `{scim_base_url}`, are specific to your connection. The setup link from the application you are connecting shows them with a copy button. The same steps appear there.

## Steps

<ol class="idp-steps">

<li class="idp-step">

<a id="app"></a>

### Start from your SAML app integration

Use the SAML app integration you created for single sign-on, or create one first. Okta adds SCIM to SAML integrations created in the classic experience.

</li>

<li class="idp-step">

<a id="enable-scim"></a>

### Turn on SCIM provisioning

On the app's General tab, select Edit in App Settings, set Provisioning to SCIM and select Save.

</li>

<li class="idp-step">

<a id="base-url"></a>

### Enter the SCIM connector base URL

On the Provisioning tab, open Settings > Integration and select Edit. Paste `{scim_base_url}` into SCIM connector base URL and enter userName as the unique identifier field for users.

<div class="setup-values">

Paste into Okta:

- SCIM base URL: `{scim_base_url}`

</div>

</li>

<li class="idp-step">

<a id="actions"></a>

### Choose the provisioning actions

Under Supported provisioning actions, select Push New Users, Push Profile Updates and Push Groups.

</li>

<li class="idp-step">

<a id="token"></a>

### Enter the bearer token

Set Authentication Mode to HTTP Header and paste `{scim_token}` into Authorization. The token is shown once in this setup; generate a new one here if you lose it.

<div class="setup-values">

Paste into Okta:

- SCIM bearer token: `{scim_token}`

</div>

Fixes: [`scim_token_invalid`](/errors/scim_token_invalid/)

</li>

<li class="idp-step">

<a id="test"></a>

### Test and save

Select Test Connector Configuration, then Save.

Fixes: [`first_scim_request_pending`](/errors/first_scim_request_pending/)

</li>

<li class="idp-step">

<a id="to-app"></a>

### Choose what Okta sends

Under Settings > To App, select Edit and turn on creating users, updating user attributes and deactivating users, then select Save.

Fixes: [`scim_user_out_of_domain`](/errors/scim_user_out_of_domain/)

:::caution[Labels not confirmed in step 7]
The Okta page read on 2026-10-11 does not list the To App option labels.
:::

</li>

<li class="idp-step">

<a id="assign"></a>

### Assign people and push groups

Assign the people or groups to sync on the Assignments tab. To sync groups, add them on the Push Groups tab.

</li>

</ol>

## Sources

- [Add SCIM provisioning to app integrations (Okta Help)](https://help.okta.com/en-us/content/topics/apps/apps_app_integration_wizard_scim.htm), read on 2026-10-11
