# Okta SCIM Setup Guide

Providing documentation to your users on how to set up SCIM with Okta is important for a smooth integration process. Below is an example guide of what this documentation could look like.

1. Begin by logging into your Okta admin console and navigating to the “Applications” section.

2. Click **Create App integration**.

3. Select **SWA - Secure Web Authentication** as the app type and click **Next**.

4. On the next page create a name for your app and enter `{your app's login page url}` in the **App’s login page URL** field. Then, click **Save**.

5. Navigate to the **General** tab of your newly created app, click on **Edit** in the **App Settings** section, and select **SCIM**. Then, click **Save**.

6. Switch to the **Provisioning** tab and click on **Edit**. Make the following changes:

- **SCIM connector base URL**: Copy/paste the **SCIM URL** from `{your application}`.
   - **Unique identifier field for users**: Enter `userName`.
   - **Supported provisioning actions**: Select the first four options, leaving `Import Groups` unchecked.
   - **Authentication Mode**: Select **HTTP Header**.
   - **Authorization**: Copy/paste the **SCIM API Key** from `{your application}`.

7. Click **Test Connector Configuration** to ensure that everything is working properly. If successful, click **Save**.

8. While still in the **Provisioning** tab, navigate to the **To App** section and set **Create Users**, **Update User Attributes**, and **Deactivate Users** to **On**. Then, click **Save**.

9. Finally, assign users or groups to your app by navigating to the **Assignments** tab and clicking on **Assign**.