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

# Okta

> How to set up the Okta connector, plus the actions and events that are available.

![Okta](https://stackone-logos.com/api/okta/filled/svg)

v3.3.4[See changelog](https://docs.stackone.com/connectors/okta/changelog.md)

[115 actions](#actions) · [21 events](#events) · 3 auth methods

IAM

## Getting Started

**1. Create or Select a Project**

Set up a new project or select an existing one. See [Organizations & Projects](https://docs.stackone.com/gateway/concepts/organizations-and-projects.md).

**2. Configure the Connector**

Enable the connector and create a Connector Profile in your project. See [Setup Connector Profile](https://docs.stackone.com/gateway/quickstart.md#setup-connector-profile).

> [card] [OAuth 2.0 (Your Own App) · Connector Profile](https://docs.stackone.com/connectors/okta/guides/connector-profile/oauth-2-0-your-own-app.md)
>
> Requires registering an OAuth app in each Okta org. Each linked account enters its own app's Client ID and Client Secret...

> [card] [OAuth 2.0 · Connector Profile](https://docs.stackone.com/connectors/okta/guides/connector-profile/oauth-2-0.md)
>
> Uses one OAuth app registered once for the connector profile. Each user signs in with their own Okta account and the con...

> [card] [API Token · Connector Profile](https://docs.stackone.com/connectors/okta/guides/connector-profile/api-token.md)
>
> No app registration required. The token inherits the permissions of the admin who created it.

Optionally, configure receiving Events for Okta into StackOne.

> [card] [Webhooks setup](https://docs.stackone.com/connectors/okta/guides/webhook-setup.md)

**3. Link an Account**

Link an account [from the dashboard](https://docs.stackone.com/connect/managing-connectors/linking-accounts.md#link-from-the-dashboard) (or via [StackOne Hub](https://docs.stackone.com/embed/account-linking/overview)).

See the guide for the authentication type chosen in the Connector Profile:

> [card] [OAuth 2.0 (Your Own App) · Link Account](https://docs.stackone.com/connectors/okta/guides/link-account/oauth-2-0-your-own-app.md)

> [card] [OAuth 2.0 · Link Account](https://docs.stackone.com/connectors/okta/guides/link-account/oauth-2-0.md)

> [card] [API Token · Link Account](https://docs.stackone.com/connectors/okta/guides/link-account/api-token.md)

**4. Use Actions**

Connect an AI platform to the linked account's actions. See [AI Platforms](https://docs.stackone.com/ai-platforms/overview.md).

Other ways to call actions are listed in [Protocols & SDKs](https://docs.stackone.com/connect/protocols-and-sdks.md).

## Actions

Authentication type

Select all
|
Clear

API Token

OAuth 2.0

OAuth 2.0 (Your Own App)

No auth methods found

Scopes

Select all
|
Clear

okta.apiTokens.read

okta.apps.manage

okta.apps.read

okta.authenticators.read

okta.deviceAssurance.read

okta.devices.manage

okta.devices.read

okta.eventHooks.read

okta.governance.accessCertifications.manage

okta.governance.accessCertifications.read

okta.governance.accessRequests.manage

okta.governance.accessRequests.read

okta.groups.manage

okta.groups.read

okta.idps.read

okta.logs.read

okta.networkZones.read

okta.policies.manage

okta.policies.read

okta.realms.manage

okta.realms.read

okta.roles.read

okta.trustedOrigins.read

okta.userTypes.manage

okta.userTypes.read

okta.users.manage

okta.users.read

openid

No scopes found

115 actions

ActionDescriptionRequired scopes

List Applications`okta_list_applications`

Lists all applications in your Okta org with pagination, filtering, and search

`okta.apps.read`

Get Application`okta_get_application`

Retrieves a specific application by ID from your Okta org. Use list\_applications to obtain the appId.

`okta.apps.read`

List Application Groups`okta_list_application_groups`

Lists all group assignments for an application. Use list\_applications to obtain the appId.

`okta.apps.read`

Get Application Group`okta_get_application_group`

Retrieves a specific group assignment for an application. Use list\_applications and list\_application\_groups to obtain re...

`okta.apps.read`

List Application Users`okta_list_application_users`

Lists all users assigned to an application. Use list\_applications to obtain the appId.

`okta.apps.read`

Get Application User`okta_get_application_user`

Retrieves a specific user assigned to an application. Use list\_applications and list\_application\_users to obtain require...

`okta.apps.read`

Assign User To Application`okta_assign_user_to_application`

Assigns a user to an application directly

`okta.apps.manage`

Unassign User From Application`okta_unassign_user_from_application`

Removes a user's assignment to an application

`okta.apps.manage`

Assign Group To Application`okta_assign_group_to_application`

Assigns a group to an application, granting access to its members

`okta.apps.manage`

Unassign Group From Application`okta_unassign_group_from_application`

Removes a group's assignment to an application

`okta.apps.manage`

Activate Application`okta_activate_application`

Activates an inactive application

`okta.apps.manage`

Deactivate Application`okta_deactivate_application`

Deactivates an active application and reconciles its group assignments

`okta.apps.manage`

List Device Assurance Policies`okta_list_device_assurance_policies`

Lists all device assurance policies in the org

`okta.deviceAssurance.read`

Get Device Assurance Policy`okta_get_device_assurance_policy`

Retrieves a single device assurance policy by ID

`okta.deviceAssurance.read`

List Authenticators`okta_list_authenticators`

Lists the authenticators configured in your org. Okta Identity Engine orgs only.

`okta.authenticators.read`

List Authenticator Methods`okta_list_authenticator_methods`

Lists the methods of an authenticator, such as sms and voice for phone. Okta Identity Engine orgs only. Use list\_authent...

`okta.authenticators.read`

List Devices`okta_list_devices`

Lists all devices with pagination support and flexible search options

`okta.devices.read`

Get Device`okta_get_device`

Retrieves a device by its ID

`okta.devices.read`

Delete Device`okta_delete_device`

Permanently deletes a device. Device must be in DEACTIVATED status first.

`okta.devices.manage`

Activate Device`okta_activate_device`

Activates a device by setting its status to ACTIVE

`okta.devices.manage`

Deactivate Device`okta_deactivate_device`

Deactivates a device by setting its status to DEACTIVATED

`okta.devices.manage`

Suspend Device`okta_suspend_device`

Suspends a device temporarily without deactivating it

`okta.devices.manage`

Unsuspend Device`okta_unsuspend_device`

Returns a suspended device to the active state

`okta.devices.manage`

Get User Factor`okta_get_user_factor`

Retrieves a single enrolled MFA factor for a user

`okta.users.read`

List Supported Factors`okta_list_supported_factors`

Lists all MFA factors a user is eligible to enrol

`okta.users.read`

List Access Certification Campaigns`okta_list_campaigns`

Lists access certification campaigns in the org

`okta.governance.accessCertifications.read`

Get Access Certification Campaign`okta_get_campaign`

Retrieves a single access certification campaign by ID

`okta.governance.accessCertifications.read`

Launch Access Certification Campaign`okta_launch_campaign`

Launches a scheduled campaign and assigns reviews to reviewers

`okta.governance.accessCertifications.manage`

List Access Requests`okta_list_access_requests`

Lists access requests raised by users in the org

`okta.governance.accessRequests.read`

Get Access Request`okta_get_access_request`

Retrieves a single access request by ID

`okta.governance.accessRequests.read`

Create Access Request`okta_create_access_request`

Raises an access request for a resource on behalf of a user

`okta.governance.accessRequests.manage`

Cancel Access Request`okta_cancel_access_request`

Cancels an open access request via the provider's Update a request operation

`okta.governance.accessRequests.manage`

List Access Request Types`okta_list_request_types`

Lists the access request types defined in the org

`okta.governance.accessRequests.read`

Get Access Request Type`okta_get_request_type`

Retrieves a single access request type by ID

`okta.governance.accessRequests.read`

Publish Access Request Type`okta_publish_request_type`

Publishes a request type, making it available to end users

`okta.governance.accessRequests.manage`

Unpublish Access Request Type`okta_unpublish_request_type`

Unpublishes a request type, returning it to draft

`okta.governance.accessRequests.manage`

List Access Certification Reviews`okta_list_reviews`

Lists access certification reviews, optionally scoped to one campaign

`okta.governance.accessCertifications.read`

Get Access Certification Review`okta_get_review`

Retrieves a single access certification review by ID

`okta.governance.accessCertifications.read`

Reassign Access Certification Reviews`okta_reassign_reviews`

Reassigns a batch of reviews to a different reviewer

`okta.governance.accessCertifications.manage`

List Groups`okta_list_groups`

Lists all groups with pagination support

`okta.groups.read`

Get Group`okta_get_group`

Retrieves a specific group by ID from your org. Use list\_groups to obtain the groupId.

`okta.groups.read`

List Group Rules`okta_list_group_rules`

Lists the group rules in your org with pagination support

`okta.groups.read`

Get Group Rule`okta_get_group_rule`

Retrieves a specific group rule by ID. Use list\_group\_rules to obtain the groupRuleId.

`okta.groups.read`

Create Group`okta_create_group`

Adds a new group with OKTA\_GROUP type to your org

`okta.groups.manage`

Update Group`okta_update_group`

Replaces the profile for a group of OKTA\_GROUP type

`okta.groups.manage`

Delete Group`okta_delete_group`

Deletes a group of OKTA\_GROUP or APP\_GROUP type from your org

`okta.groups.manage`

List Group Members`okta_list_group_members`

Lists all users that are a member of a group. Use list\_groups to obtain the groupId.

`okta.groups.read`

Add User To Group`okta_add_user_to_group`

Assigns a user to a group with OKTA\_GROUP type. Use list\_groups and list\_users to obtain required IDs.

`okta.groups.manage`

Remove User From Group`okta_remove_user_from_group`

Unassigns a user from a group with OKTA\_GROUP type. Use list\_groups and list\_group\_members to obtain required IDs.

`okta.groups.manage`

Activate Group Rule`okta_activate_group_rule`

Activates a group rule so it begins assigning members

`okta.groups.manage`

Deactivate Group Rule`okta_deactivate_group_rule`

Deactivates a group rule so it stops assigning members

`okta.groups.manage`

List Group Assigned Applications`okta_list_group_assigned_applications`

Lists the applications assigned to a group

`okta.groups.read`

List Group Owners`okta_list_group_owners`

Lists the owners of a group

`okta.groups.read`

List Policies`okta_list_policies`

Lists all policies of a given type

`okta.policies.read`

Get Policy`okta_get_policy`

Retrieves a specific policy by ID. Use list\_policies to obtain the policyId.

`okta.policies.read`

Create Policy`okta_create_policy`

Creates a new policy of the specified type. The returned policy ID can be used with get\_policy, replace\_policy, delete\_p...

`okta.policies.manage`

Replace Policy`okta_replace_policy`

Replaces a policy with the provided data. Use list\_policies or create\_policy to obtain the policyId.

`okta.policies.manage`

Delete Policy`okta_delete_policy`

Deletes a policy by ID

`okta.policies.manage`

Activate Policy`okta_activate_policy`

Activates a policy by setting its status to ACTIVE

`okta.policies.manage`

Deactivate Policy`okta_deactivate_policy`

Deactivates a policy by setting its status to INACTIVE

`okta.policies.manage`

Clone An Existing Policy`okta_clone_policy`

Clones an existing ACCESS\_POLICY to create a copy

`okta.policies.manage`

Create A Policy Simulation`okta_create_policy_simulation`

Simulates a policy evaluation to test access outcomes

`okta.policies.read`

List All Apps Mapped To A Policy`okta_list_policy_apps`

Lists all applications mapped to an ACCESS\_POLICY. Use list\_policies with type ACCESS\_POLICY to obtain the policyId.

`okta.policies.read`

List All Resources Mapped To A Policy`okta_list_policy_mappings`

Lists all resources mapped to a policy. Use list\_policies to obtain the policyId.

`okta.policies.read`

Retrieve A Policy Resource Mapping`okta_retrieve_policy_mapping`

Retrieves a specific policy resource mapping. Use list\_policy\_mappings to obtain the mappingId.

`okta.policies.read`

List All Policy Rules`okta_list_policy_rules`

Lists all rules for a specific policy. Use list\_policies to obtain the policyId first.

`okta.policies.read`

Retrieve A Policy Rule`okta_get_policy_rule`

Retrieves a specific rule for a policy

`okta.policies.read`

Create Policy Rule`okta_create_policy_rule`

Creates a new rule for a policy. Use list\_policies to obtain the policyId. The created rule ID is returned in the respon...

`okta.policies.manage`

Replace Policy Rule`okta_replace_policy_rule`

Replaces a policy rule with the provided data. Use list\_policy\_rules to obtain the ruleId.

`okta.policies.manage`

Delete Policy Rule`okta_delete_policy_rule`

Deletes a policy rule. Use list\_policy\_rules to obtain the ruleId.

`okta.policies.manage`

Activate Policy Rule`okta_activate_policy_rule`

Activates a policy rule. Use list\_policy\_rules to obtain the ruleId.

`okta.policies.manage`

Deactivate Policy Rule`okta_deactivate_policy_rule`

Deactivates a policy rule. Use list\_policy\_rules to obtain the ruleId.

`okta.policies.manage`

List Realms`okta_list_realms`

Lists all Realms with pagination support

`okta.realms.read`

Get Realm`okta_get_realm`

Retrieves a Realm by its ID

`okta.realms.read`

Create Realm`okta_create_realm`

Creates a new Realm

`okta.realms.manage`

Update Realm`okta_update_realm`

Replaces the realm profile by its ID

`okta.realms.manage`

Delete Realm`okta_delete_realm`

Deletes a Realm by its ID

`okta.realms.manage`

List User Assigned Roles`okta_list_user_assigned_roles`

Lists all administrator roles assigned to a user

`okta.roles.read`

List Custom Roles`okta_list_custom_roles`

Lists the custom admin roles in your org, plus IAM-based standard roles such as WORKFLOWS\_ADMIN.

`okta.roles.read`

List Users With Role Assignments`okta_list_users_with_role_assignments`

Lists every user in the org that holds an administrator role

`okta.roles.read`

List API Tokens`okta_list_api_tokens`

Lists the metadata of the active API tokens in your org

`okta.apiTokens.read`

List Event Hooks`okta_list_event_hooks`

Lists the event hooks configured in your org

`okta.eventHooks.read`

List Identity Providers`okta_list_identity_providers`

Lists the identity provider (IdP) integrations in your org with pagination support

`okta.idps.read`

List Network Zones`okta_list_network_zones`

Lists the network zones in your org with pagination support

`okta.networkZones.read`

List Trusted Origins`okta_list_trusted_origins`

Lists the trusted origins in your org with pagination support

`okta.trustedOrigins.read`

Get User Info`okta_get_userinfo`

Retrieves information about the currently authenticated user from the OAuth 2.0 UserInfo endpoint.

`openid`

List System Log Events`okta_list_system_logs`

Lists events from the Okta System Log with filtering, keyword search, and pagination

`okta.logs.read`

List Users`okta_list_users`

Lists all users in your org with pagination and flexible query options

`okta.users.read`

Get User`okta_get_user`

Retrieves a user from your Okta org by ID, login, or shortname. Use list\_users to find the user ID, or pass the user's l...

`okta.users.read`

Create User`okta_create_user`

Creates a new user in your Okta org with or without credentials

`okta.users.manage`

Update User`okta_update_user`

Updates a user's profile or credentials with partial update semantics. Use list\_users or get\_user to obtain the user ID.

`okta.users.manage`

Replace User`okta_replace_user`

Replaces a user's profile, credentials, or both using strict-update semantics. Use get\_user first to fetch the current p...

`okta.users.manage`

List User Blocks`okta_list_user_blocks`

Lists information about how a user is blocked from accessing their account. Use list\_users to obtain the user ID.

`okta.users.read`

List User Factors`okta_list_user_factors`

Lists the MFA factors a user has enrolled. Use list\_users to obtain the user ID.

`okta.users.read`

List User Authenticator Enrollments`okta_list_user_authenticator_enrollments`

Lists all authenticators a user has enrolled. Okta Identity Engine orgs only. Use list\_users to obtain the user ID.

`okta.users.read`

List User Groups`okta_list_user_groups`

Lists the groups a user belongs to. Use list\_users to obtain the user ID.

`okta.users.read`

List User Roles`okta_list_user_roles`

Lists the admin roles assigned to a user, including standard and custom roles. Use list\_users to obtain the user ID.

`okta.roles.read`

Delete User`okta_delete_user`

Permanently deletes a user from your Okta organization. Use list\_users to obtain the user ID. Requires two calls — first...

`okta.users.manage`

Suspend User`okta_suspend_user`

Suspends an active user, blocking sign-in without removing access

`okta.users.manage`

Unsuspend User`okta_unsuspend_user`

Returns a suspended user to the active state

`okta.users.manage`

Deactivate User`okta_deactivate_user`

Deactivates a user and deprovisions them from all assigned apps

`okta.users.manage`

Activate User`okta_activate_user`

Activates a staged or deprovisioned user

`okta.users.manage`

Reactivate User`okta_reactivate_user`

Restarts the activation workflow for a provisioned or recovering user

`okta.users.manage`

Unlock User`okta_unlock_user`

Unlocks a locked-out user so they can sign in again

`okta.users.manage`

Reset User Password`okta_reset_password`

Starts a password reset and moves the user into recovery

`okta.users.manage`

Expire User Password`okta_expire_password`

Expires a user password, forcing a change at next sign-in

`okta.users.manage`

Revoke User Sessions`okta_revoke_user_sessions`

Revokes a user's active sessions, forcing re-authentication

`okta.users.manage`

List User App Links`okta_list_user_app_links`

Lists the apps a user can reach, directly or through a group

`okta.users.read`

List User Devices`okta_list_user_devices`

Lists the devices enrolled by a specific user

`okta.users.read`

List User Types`okta_list_user_types`

Lists all user types in your Okta organization

`okta.userTypes.read`

Get User Type`okta_get_user_type`

Retrieves a user type by ID

`okta.userTypes.read`

Create User Type`okta_create_user_type`

Creates a new user type in your Okta organization

`okta.userTypes.manage`

Update User Type`okta_update_user_type`

Partially updates an existing user type

`okta.userTypes.manage`

Replace User Type`okta_replace_user_type`

Fully replaces an existing user type

`okta.userTypes.manage`

Delete User Type`okta_delete_user_type`

Permanently deletes a user type

`okta.userTypes.manage`

## Events

Tags

Select all
|
Clear

API Tokens

Applications

Devices

Groups

Health Checks

Policies

Users

Webhooks

No tags found

21 events

EventDescriptionTags

Active Check`okta_active_check`

Responds to Okta's one-time verification GET by echoing the x-okta-verification-challenge header value back in the JSON...

Health Checks

User Created`okta_webhook_user_lifecycle_create`

Emitted when a new user account is created in Okta (provisioned by an admin, sourced from a directory, or self-registere...

UsersWebhooks

User Activated`okta_webhook_user_lifecycle_activate`

Emitted when a user transitions from STAGED, PROVISIONED, or DEPROVISIONED to ACTIVE status and gains access. Maps to Ok...

UsersWebhooks

User Deactivated`okta_webhook_user_lifecycle_deactivate`

Emitted when a user is deactivated — access is revoked and sessions are invalidated, but the account is preserved (statu...

UsersWebhooks

User Suspended`okta_webhook_user_lifecycle_suspend`

Emitted when a user is temporarily suspended — sign-in is blocked and sessions are invalidated, but the user can be unsu...

UsersWebhooks

User Delete Initiated`okta_webhook_user_lifecycle_delete_initiated`

Emitted when a user-deletion request is initiated — the user enters DELETED status. Note that \`user.lifecycle.delete.con...

UsersWebhooks

User Password Reset`okta_webhook_user_account_reset_password`

Emitted when a user's password is reset (admin-initiated, self-service, or via the connector's reset action). Maps to Ok...

UsersWebhooks

User Profile Updated`okta_webhook_user_account_update_profile`

Emitted when one or more user profile attributes are changed (first name, last name, email, phone, custom attributes, et...

UsersWebhooks

User Universal Logout`okta_webhook_user_authentication_universal_logout`

Emitted when a Universal Logout signal terminates all of a user's sessions and tokens across federated apps. Maps to Okt...

UsersWebhooks

Group Created`okta_webhook_group_lifecycle_create`

Emitted when a new group is created in Okta. Maps to Okta event `group.lifecycle.create`.

GroupsWebhooks

Group Deleted`okta_webhook_group_lifecycle_delete`

Emitted when a group is deleted from Okta. Note that there is no `group.lifecycle.modify` or `update` event — group attr...

GroupsWebhooks

Group Member Added`okta_webhook_group_user_membership_add`

Emitted when a user is added as a member of a group. Maps to Okta event `group.user_membership.add`.

GroupsUsersWebhooks

Group Member Removed`okta_webhook_group_user_membership_remove`

Emitted when a user is removed from a group's membership. Maps to Okta event `group.user_membership.remove`.

GroupsUsersWebhooks

Device Activated`okta_webhook_device_lifecycle_activate`

Emitted when a device transitions from STAGED to ACTIVE status and becomes trusted. Maps to Okta event \`device.lifecycle...

DevicesWebhooks

Device Deactivated`okta_webhook_device_lifecycle_deactivate`

Emitted when a device is deactivated and loses its trusted status. Maps to Okta event `device.lifecycle.deactivate`.

DevicesWebhooks

Device Deleted`okta_webhook_device_lifecycle_delete`

Emitted when a device is permanently removed from Okta. Maps to Okta event `device.lifecycle.delete`.

DevicesWebhooks

App User Assigned`okta_webhook_application_user_membership_add`

Emitted when a user is assigned to an application — the core "who has access to what" IAM signal. Maps to Okta event \`ap...

ApplicationsUsersWebhooks

App User Removed`okta_webhook_application_user_membership_remove`

Emitted when a user is removed from an application — deprovisioning / access-loss signal critical for downstream cleanup...

ApplicationsUsersWebhooks

App Sign-On Access Denied`okta_webhook_application_policy_sign_on_deny_access`

Emitted when an application sign-on policy denies a user access during sign-in. Security / compliance signal — useful fo...

ApplicationsPoliciesWebhooks

API Token Created`okta_webhook_system_api_token_create`

Emitted when a new Okta admin API token is created. Security-critical signal — useful for audit logging, anomaly detecti...

API TokensWebhooks

API Token Revoked`okta_webhook_system_api_token_revoke`

Emitted when an Okta admin API token is revoked. Security signal — useful for tracking credential lifecycle and detectin...

API TokensWebhooks


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