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

# SCIM with Okta

> Configure SCIM user provisioning for Gumloop with Okta

SCIM (system for cross-domain identity management) lets Okta communicate with Gumloop on a recurring basis: Okta tells Gumloop which users should have access — and which should not — along with useful user *attributes*. Gumloop uses this to provision, deprovision, and update users automatically (see [SSO, SAML & SCIM](/enterprise-features/sso_saml_scim#scim-provisioning)).

Connecting Okta to Gumloop requires sharing two pieces of information with Okta, both of which come from Gumloop:

1. A **base URL** that Okta will perform operations on (e.g. via HTTP PATCH)
2. A **bearer token** that Okta will include with its requests

## Before you start: get your base URL and bearer token from Gumloop

SCIM is an Enterprise add-on — a Gumloop organization admin requests enablement via [support@gumloop.com](mailto:support@gumloop.com), then generates a setup link at [gumloop.com/settings/organization/sso](https://www.gumloop.com/settings/organization/sso). The setup page shows your SCIM **base URL** and lets you generate the **bearer token**.

<Warning>
  Gumloop **does not store bearer tokens** — the token is shown once, at generation time. You can generate a new one at any time, which immediately invalidates the previous token.
</Warning>

# Configuring Okta

Start by navigating to the relevant application in Okta. If you are unsure how to create such an Application, please review the [SAML with Okta](/enterprise-features/idp-guides/saml-with-okta) guide for an in-depth explanation.

<Frame caption="Visiting an Application in Okta">
  <img src="https://mintcdn.com/agenthub/zL6qAgistqWft1iw/images/idp-guides/idp-scim-assets/okta/0.png?fit=max&auto=format&n=zL6qAgistqWft1iw&q=85&s=9a7df50aeaf5e3e8d1747217a91c2f9d" width="1920" height="1040" data-path="images/idp-guides/idp-scim-assets/okta/0.png" />
</Frame>

Make sure you're on the *General* tab and press *Edit* on the *App Settings* card.

<Frame caption="Editing app settings">
  <img src="https://mintcdn.com/agenthub/y3cK9L1cPivE2Xif/images/idp-guides/idp-scim-assets/okta/1.png?fit=max&auto=format&n=y3cK9L1cPivE2Xif&q=85&s=845ec8d90f707773b4ee7887810b3616" width="1920" height="1025" data-path="images/idp-guides/idp-scim-assets/okta/1.png" />
</Frame>

Make sure the Provisioning box shows a checkmark. By default, Okta leaves this box unchecked.

<Frame caption="Checking the `Enable SCIM provisioning` field">
  <img src="https://mintcdn.com/agenthub/y3cK9L1cPivE2Xif/images/idp-guides/idp-scim-assets/okta/3.png?fit=max&auto=format&n=y3cK9L1cPivE2Xif&q=85&s=b57ea6f2304ac8d2af3e6b2566d083a2" width="1920" height="1040" data-path="images/idp-guides/idp-scim-assets/okta/3.png" />
</Frame>

Press *Save* in the lower right corner.

<Frame caption="Pressing save">
  <img src="https://mintcdn.com/agenthub/y3cK9L1cPivE2Xif/images/idp-guides/idp-scim-assets/okta/2.png?fit=max&auto=format&n=y3cK9L1cPivE2Xif&q=85&s=21eecfdd949ee04f35a67004f968df8c" width="1920" height="1040" data-path="images/idp-guides/idp-scim-assets/okta/2.png" />
</Frame>

Navigate to the *Provisioning* tab for the Application.

<Frame caption="Navigating to the Provisioning tab">
  <img src="https://mintcdn.com/agenthub/y3cK9L1cPivE2Xif/images/idp-guides/idp-scim-assets/okta/4.png?fit=max&auto=format&n=y3cK9L1cPivE2Xif&q=85&s=bcd9b372736c9899ac8a3c4ff1e52662" width="1920" height="1040" data-path="images/idp-guides/idp-scim-assets/okta/4.png" />
</Frame>

On the *Provisioning* tab, click the *Edit* button toward the top right of the card.

<Frame caption="Clicking the Edit button">
  <img src="https://mintcdn.com/agenthub/y3cK9L1cPivE2Xif/images/idp-guides/idp-scim-assets/okta/6.png?fit=max&auto=format&n=y3cK9L1cPivE2Xif&q=85&s=f6889d3cf4fcc3c0d4a80236abbae4ef" width="1920" height="1040" data-path="images/idp-guides/idp-scim-assets/okta/6.png" />
</Frame>

Look for a field marked *SCIM connector base URL*. This is the *base URL* from your Gumloop SCIM setup page. Paste it here.

<Frame caption="Inserting the SCIM connector base URL">
  <img src="https://mintcdn.com/agenthub/y3cK9L1cPivE2Xif/images/idp-guides/idp-scim-assets/okta/9.png?fit=max&auto=format&n=y3cK9L1cPivE2Xif&q=85&s=d8f7bd5d13e8deeadf0930c863223b73" width="1927" height="1040" data-path="images/idp-guides/idp-scim-assets/okta/9.png" />
</Frame>

Next, look for a field marked *Unique identifier field for users*. We need this to say "email" exactly. Gumloop relies on users' emails as a unique identifier.

<Frame caption="Entering 'email' as the unique identifier field">
  <img src="https://mintcdn.com/agenthub/y3cK9L1cPivE2Xif/images/idp-guides/idp-scim-assets/okta/8.png?fit=max&auto=format&n=y3cK9L1cPivE2Xif&q=85&s=129bc102edd23edd6cd4eec20207a06e" width="1933" height="1048" data-path="images/idp-guides/idp-scim-assets/okta/8.png" />
</Frame>

Look for a series of checkboxes labeled *Supported provisioning actions.* You will see five checkboxes. Set your configuration to match the following:

* [x] &#x20;Import New Users and Profile Updates
* [x] &#x20;Push New Users
* [x] &#x20;Push Profile Updates
* [x] &#x20;Push Groups
* [ ] &#x20;Import Groups

**Ensure that *Import Groups* remains unchecked.** The SCIM Connection will fail otherwise.

<Frame caption="Editing the 'Supported provisioning actions'">
  <img src="https://mintcdn.com/agenthub/y3cK9L1cPivE2Xif/images/idp-guides/idp-scim-assets/okta/12.png?fit=max&auto=format&n=y3cK9L1cPivE2Xif&q=85&s=fa78be94d233290b3e0559f45583babc" width="1920" height="1040" data-path="images/idp-guides/idp-scim-assets/okta/12.png" />
</Frame>

Now look for a dropdown menu labeled *Authentication Mode*. This must change from its default value to *HTTP Header*.

<Frame caption="Changing the 'Authentication Mode' to 'HTTP Header'">
  <img src="https://mintcdn.com/agenthub/y3cK9L1cPivE2Xif/images/idp-guides/idp-scim-assets/okta/11.png?fit=max&auto=format&n=y3cK9L1cPivE2Xif&q=85&s=53a7142c71ec6e804d02f00ac122b9d4" width="1920" height="1040" data-path="images/idp-guides/idp-scim-assets/okta/11.png" />
</Frame>

Now paste the bearer token from Gumloop in the field marked *Authorization*.

<Frame caption="Pasting the bearer token from Gumloop">
  <img src="https://mintcdn.com/agenthub/y3cK9L1cPivE2Xif/images/idp-guides/idp-scim-assets/okta/20.png?fit=max&auto=format&n=y3cK9L1cPivE2Xif&q=85&s=ee9f97dc33d197ce2313a2ba9fcac31a" width="1920" height="1040" data-path="images/idp-guides/idp-scim-assets/okta/20.png" />
</Frame>

Then once more hit *Save* in the lower right.

<Frame caption="Saving edits to the SCIM connection">
  <img src="https://mintcdn.com/agenthub/y3cK9L1cPivE2Xif/images/idp-guides/idp-scim-assets/okta/10.png?fit=max&auto=format&n=y3cK9L1cPivE2Xif&q=85&s=4c046f8df50de55032180649d18c020f" width="1920" height="1040" data-path="images/idp-guides/idp-scim-assets/okta/10.png" />
</Frame>

Now look in the sidebar to the left and find the item marked *To App*. Click this.

<Frame caption="Navigating to the setting for provisioning to the app">
  <img src="https://mintcdn.com/agenthub/y3cK9L1cPivE2Xif/images/idp-guides/idp-scim-assets/okta/13.png?fit=max&auto=format&n=y3cK9L1cPivE2Xif&q=85&s=843114f199cd769074c02bad05bdb582" width="1920" height="1040" data-path="images/idp-guides/idp-scim-assets/okta/13.png" />
</Frame>

You'll see four checkboxes. Set them to match the following:

* [x] Create Users
* [x] Update User Attributes
* [x] Deactivate Users
* [ ] Sync Password

Then press *Save* in the lower right.

<Frame caption="Saving edits to the SCIM connection">
  <img src="https://mintcdn.com/agenthub/y3cK9L1cPivE2Xif/images/idp-guides/idp-scim-assets/okta/16.png?fit=max&auto=format&n=y3cK9L1cPivE2Xif&q=85&s=2d64bdb8d71e325802f3d03d94e0f84e" width="1920" height="1040" data-path="images/idp-guides/idp-scim-assets/okta/16.png" />
</Frame>

Now navigate to the *Assignments* tab.

<Frame caption="Navigating to the 'Assignments' settings">
  <img src="https://mintcdn.com/agenthub/y3cK9L1cPivE2Xif/images/idp-guides/idp-scim-assets/okta/15.png?fit=max&auto=format&n=y3cK9L1cPivE2Xif&q=85&s=e734a2fa0c96d78f89e7e40ad1459064" width="1920" height="1040" data-path="images/idp-guides/idp-scim-assets/okta/15.png" />
</Frame>

Using the *Assign* dropdown, choose to assign the relevant People (i.e. users) or Groups. This guide uses People.

<Frame caption="Assigning People to the Application">
  <img src="https://mintcdn.com/agenthub/y3cK9L1cPivE2Xif/images/idp-guides/idp-scim-assets/okta/14.png?fit=max&auto=format&n=y3cK9L1cPivE2Xif&q=85&s=b5166ca82bf21735efeeb76101f86a29" width="1920" height="1040" data-path="images/idp-guides/idp-scim-assets/okta/14.png" />
</Frame>

You'll now see a list of People. For each that you wish to assign to the Application, press the *Assign* button to the right.

<Frame caption="Starting the assignment flow for a person">
  <img src="https://mintcdn.com/agenthub/y3cK9L1cPivE2Xif/images/idp-guides/idp-scim-assets/okta/18.png?fit=max&auto=format&n=y3cK9L1cPivE2Xif&q=85&s=0c2016ce97fbc70d6eb75e93879a5eb6" width="1920" height="1040" data-path="images/idp-guides/idp-scim-assets/okta/18.png" />
</Frame>

You'll have the opportunity to edit this person's attributes, but it's usually fine just to scroll down and press *Save and Go Back*.

<Frame caption="Pressing 'Save and Go Back'">
  <img src="https://mintcdn.com/agenthub/y3cK9L1cPivE2Xif/images/idp-guides/idp-scim-assets/okta/17.png?fit=max&auto=format&n=y3cK9L1cPivE2Xif&q=85&s=f4fef3d3a2c9c2ce7c3e1381072f3052" width="1920" height="1040" data-path="images/idp-guides/idp-scim-assets/okta/17.png" />
</Frame>

Unless you wish to add other People to the Application, you can now press *Done*.

<Frame caption="Finishing assignment to the Application">
  <img src="https://mintcdn.com/agenthub/y3cK9L1cPivE2Xif/images/idp-guides/idp-scim-assets/okta/19.png?fit=max&auto=format&n=y3cK9L1cPivE2Xif&q=85&s=a3f8c4a46958a8fa4bb03d21684047bf" width="1920" height="1040" data-path="images/idp-guides/idp-scim-assets/okta/19.png" />
</Frame>

Okta is now pushing users to Gumloop.

<Note>
  If you assigned users to the Application *before* setting up the SCIM Connection, you may need to instruct Okta to force sync. You can read more [here](https://support.okta.com/help/s/article/How-To-Use-The-Force-Sync-Option?language=en_US).
</Note>

# Enabling synchronization in Gumloop

Pushed users only reach your organization once synchronization is enabled on the Gumloop side. A Gumloop organization admin returns to [gumloop.com/settings/organization/sso](https://www.gumloop.com/settings/organization/sso), selects the SCIM directory, and enables synchronization — see [Setting Up SCIM](/enterprise-features/sso_saml_scim#setting-up-scim).

Once enabled, configuration is complete: assigned users appear in your organization's member list after the next sync (automatic every 15 minutes, or triggered manually by the admin).
