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

# Okta

> Connect Okta to discover which apps your team uses and who has access to each one.

Connect **Okta** to see which apps your team signs in to through your Okta account. ClearSpend AI reads your Okta directory and shows you the apps, who is assigned to each one, and how that maps to your existing subscriptions.

Open **Integrations** and connect from the **Okta** card.

> [!NOTE]
>
> Okta is **read-only**. ClearSpend AI never changes anything in your Okta account — it only reads app and user data to help you understand your SaaS footprint.

## What Okta shows you

| What ClearSpend AI reads | Where you see it |
| - | - |
| Apps your team signs in to through Okta | [Subscriptions](https://docs.clearspend.ai/features/subscriptions) — matched to existing vendors |
| Users assigned to each app | Subscription detail — ownership and usage |

Okta data does **not** create charges or invoices. It helps you see who is using which tools, so you can assign owners and spot apps that may need to be cancelled or renewed.

## What you need

* An **Okta domain** — your Okta org URL, for example `acme.okta.com`
* A **read-only API token** from Okta — generated under **Security → API → Tokens** in your Okta admin panel

**Owners**, **Admins**, and **Contributors** can connect Okta. See [Roles and permissions](https://docs.clearspend.ai/reference/roles-permissions.md).

## Connect Okta

**1. Generate a read-only API token in Okta**

In your Okta admin panel, go to **Security → API → Tokens** and create a new token. Copy it — you won't be able to see it again after closing the dialog.

**2. Open Integrations in ClearSpend AI**

Go to **Integrations** in the sidebar and find the **Okta** card.

**3. Click Connect**

Enter your **Okta domain** (e.g. `acme.okta.com`) and paste your **API token**. Click **Connect**.

**4. Run a sync**

Click **Sync** on the Okta card to pull your app and user data. ClearSpend AI reads your Okta directory and maps apps to subscriptions.

> [!TIP]
>
> **It worked when:** the Okta card on Integrations shows a **last sync** time. Open [Subscriptions](https://docs.clearspend.ai/features/subscriptions) — you should see apps discovered from Okta matched to your existing vendors.

## How sync works

On each sync, ClearSpend AI:

1. Reads the apps your Okta users are assigned to
2. Matches them to subscriptions already in your workspace by vendor name
3. Updates the subscription with Okta-sourced usage and user data

Syncs are **on demand** — ClearSpend AI does not sync Okta automatically. Click **Sync** on the Okta card whenever you want a fresh pull.

## Disconnect

On **Integrations**, expand the **Okta** card and disconnect. Data already pulled stays in your workspace, but future syncs stop.

## Related

* [Subscriptions](https://docs.clearspend.ai/features/subscriptions)
* [Google Workspace](https://docs.clearspend.ai/connect/google-workspace.md)
* [Integrations overview](https://docs.clearspend.ai/connect/integrations.md)
* [Roles and permissions](https://docs.clearspend.ai/reference/roles-permissions.md)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.