---
title: "Okta Integration"
slug: "okta-integration"
tags: ["Users and Permissions"]
updated: 2025-05-24T18:16:42Z
published: 2025-05-24T18:16:42Z
canonical: "support.controlup.com/okta-integration"
---

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

# Okta Integration

This article describes how to configure a Okta connection. Read [IdP integration overview](/v1/docs/idp-connection-overview) for details on how you can use identity provider integrations with ControlUp.

## Prerequisite permission

To set up an Okta connection, your ControlUp account must have the **Identity Providers** permission.

## Step 1 - Create an API token in Okta

You must create an API token in Okta with the required permissions depending on which ControlUp module uses the connection.

**Required API token permissions:**

- For Okta connections configured for Secure DX, the API token requires the following permissions:
  - okta.logs.read
  - okta.users.read

For details, read the Okta documentation for [managing API tokens](https://help.okta.com/en-us/content/topics/security/api.htm?cshid=ext_API) and [creating API tokens with custom permissions](https://support.okta.com/help/s/article/How-To-Create-an-API-Token-With-Custom-Permissions?language=en_US).

**To create an API token:**

1. In the Okta Admin Console, go to **Security > API > Tokens > Create token**.  

![Create Token Button](https://cdn.document360.io/098100b7-b9da-4bea-b4b9-017140ab863e/Images/Documentation/CreateTokenButton.png)
2. Enter a custom name for the token and click **Create token**.
3. Copy the token value.

## Step 2 - Set up the Okta connection in ControlUp

1. In ControlUp, go to **Settings > Integrations > Identity Providers** and click the **Okta** icon to start adding a new Okta connection. ![Start Adding Okta integration in ControlUp](https://cdn.document360.io/098100b7-b9da-4bea-b4b9-017140ab863e/Images/Documentation/StartAddingOktaIntegrationInControlUp.png)
2. Under **Purpose**, select which ControlUp product area uses the integration. This selection determines what data ControlUp pulls from Okta.
3. Enter a **Name** for the Okta connection.
4. In the **Domain** field, enter your Okta domain. Read [Find your Okta domain](https://developer.okta.com/docs/guides/find-your-domain/main/) for more information.
5. In the **API Token** field, paste the API token that you created in Okta.
6. Click **Add Connection**.
7. Find the connection you added in the table and click **Test Connection** to check that the connection is configured correctly. **This is a mandatory step**.