Configuring Provisioning for Litmos

This guide provides the steps required to configure Provisioning for Litmos.


Okta recently added support for Account Owner Access level for the Litmos application. In case your existing Litmos application does not support Account Owner Access level when assigning a user, you have to create a new instance of the Litmos application in your Okta org. If this is not acceptable, contact Okta Support and ask them to update your Litmos Application and add Account Owner Access level.


Supported Features

The following provisioning features are supported:


Complete the following before you configure provisioning for Litmos:

  1. Log in to your Litmos account as an Account Owner or Administrator.

  2. Click on the My Profile & Settings link in the top of the page:


  3. Scroll down and make a copy of your API key. You will need it to setup Litmos application in Okta.


Configuration Steps

Configure your Provisioning settings for Litmos as follows:

  1. Check the Enable API Integration box.

  2. Enter your Litmos API Credentials:

    • API Key: Enter the API key you copied from Litmos (see Requirements above). Also, make sure that your AccessLevel is Administrator or Account Owner.

    • Company: Enter your company name. This is used to identify you in Litmos. You can enter any value that identifies your organization in Litmos.


  3. Click Test API Credentials. If your API credentials are valid, you will see a success message, as shown here:


  4. Select To App in the left panel, then select the Provisioning Features you want to enable:


  5. Click Save.

  6. You can now assign people to the app, if needed (see below).

User Provisioning

  1. To assign users to the Litmos app, open the app, select the People tab and then click the Assign to People button:


  2. In the Assign Litmos to People dialog, select a user, then click the Assign button:


  3. You can select which access level grant to each user by selecting the corresponding value from the AccessLevel dropdown menu:


  4. Click the Save and Go Back button.

Schema Discovery

This feature allows you to extend the Litmos App User profile with additional attributes using the Profile Editor and then sync them with Litmos.


Note that IsCustomUsername and SkipFirstLogin attributes can be set only one time; upon user creation and cannot be updated later.