Skip to content
Scalekit Docs
Talk to an Engineer Dashboard

Connect AI agents to Okta

Scalekit connector
Open markdown

The Okta connector lets your AI agent act in each user's Okta account. Each user connects their own Okta API key once, and Scalekit sends it with every call, so your agent never handles credentials. It comes with 23 tools.

Tools
23
What they doRead · write · destructive
13 · 8 · 213 read8 write2 destructive
Users sign in with

Setup

  1. Install the SDK

    Terminal window
    npm install @scalekit-sdk/node dotenv
  2. Set your credentials

    Add your Scalekit credentials to your .env file. Find values in app.scalekit.com > Developers > API Credentials.

    .env
    SCALEKIT_ENVIRONMENT_URL=<your-environment-url>
    SCALEKIT_CLIENT_ID=<your-client-id>
    SCALEKIT_CLIENT_SECRET=<your-client-secret>
  3. Create the Okta connection

    In AgentKit > Connections, create an Okta connection. The name you give it is the connection_name your code passes. See Configure connections.

  4. Authorize a user and make your first call

    quickstart.mts
    import { ScalekitClient } from '@scalekit-sdk/node'
    import 'dotenv/config'
    import { createInterface } from 'node:readline/promises'
    const scalekit = new ScalekitClient(
    process.env.SCALEKIT_ENVIRONMENT_URL,
    process.env.SCALEKIT_CLIENT_ID,
    process.env.SCALEKIT_CLIENT_SECRET,
    )
    const actions = scalekit.actions
    const connector = 'okta'
    const identifier = 'user_123'
    // Generate an authorization link for the user
    const { link } = await actions.getAuthorizationLink({ connectionName: connector, identifier })
    console.log('Authorize Okta:', link)
    const rl = createInterface({ input: process.stdin, output: process.stdout })
    await rl.question('Press Enter after authorizing...')
    rl.close()
    // Make your first call
    const result = await actions.executeTool({
    connector,
    identifier,
    toolName: 'okta_apps_list',
    toolInput: {},
    })
    console.log(result)
    Terminal window
    npx tsx quickstart.mts

    Each user opens the link once and enters their Okta credentials there. See Authorize a user for the full flow and statuses.

Tools

Pass the exact name to execute_tool
Try in PlaygroundRequest a tool
  • okta_app_getGet one Okta application by ID.Read-only

    Get App

    Get one Okta application by ID. Returns id, name, label, status, signOnMode, features, settings and credentials settings. Use okta_app_get when you know the app ID. Use okta_apps_list to find it.

    Inputs

    app_idstringrequired
    Okta application ID (starts with 0oa). Get it from okta_apps_list. Example: 0oa1a2b3c4d5e6f7g8h9
  • okta_app_groups_listList the groups assigned to an Okta application.Read-only

    List App Group Assignments

    List the groups assigned to an Okta application. Returns assignments with id (the group ID), priority and profile. Use okta_app_groups_list for one app's groups. Use okta_app_users_list for its users.

    Inputs

    app_idstringrequired
    Okta application ID (starts with 0oa). Get it from okta_apps_list. Example: 0oa1a2b3c4d5e6f7g8h9
    afterstring
    Pagination cursor for the next page. Okta puts it in the after parameter of the rel="next" Link response header; for app group assignments Okta uses the id of the last item on the previous page. Leave empty for the first page. Example: 00g1a2b3c4d5e6f7g8h9
    limitinteger
    Maximum number of results to return in this page. Okta default is 20. Maximum is 200. Example: 20
    qstring
    Finds assigned groups whose name starts with this text. Example: Eng
  • okta_app_users_listList the users assigned to an Okta application.Read-only

    List App Users

    List the users assigned to an Okta application. Returns app user objects with id (the Okta user ID), scope (USER or GROUP), status, credentials.userName and the app-specific profile. Use okta_app_users_list for one app's users. Use okta_app_groups_list for its group assignments.

    Inputs

    app_idstringrequired
    Okta application ID (starts with 0oa). Get it from okta_apps_list. Example: 0oa1a2b3c4d5e6f7g8h9
    afterstring
    Pagination cursor for the next page. Okta puts it in the after parameter of the rel="next" Link response header; for app users Okta uses the id of the last item on the previous page. Leave empty for the first page. Example: 00u1a2b3c4d5e6f7g8h9
    limitinteger
    Maximum number of results to return in this page. Okta default is 50. Maximum is 500. Example: 50
    qstring
    Finds assigned users whose userName, firstName, lastName or email starts with this text. Example: jane
  • okta_apps_listList applications in the Okta org, optionally by name or label prefix or a filter expression.Read-only

    List Apps

    List applications in the Okta org, optionally by name or label prefix or a filter expression. Returns app objects with id, name, label, status, signOnMode and created. Use okta_apps_list to find apps or their IDs. Use okta_app_get for one app by ID.

    Inputs

    afterstring
    Pagination cursor for the next page. Okta puts it in the after parameter of the rel="next" Link response header; for apps Okta uses the id of the last item on the previous page. Leave empty for the first page. Example: 0oa1a2b3c4d5e6f7g8h9
    filterstring
    Okta filter expression on status, name, user.id or group.id. Example: status eq "ACTIVE"
    limitinteger
    Maximum number of results to return in this page. Okta returns all apps by default. Example: 50
    qstring
    Finds apps whose name or label starts with this text. Example: Salesforce
  • okta_group_getGet one Okta group by ID.Read-only

    Get Group

    Get one Okta group by ID. Returns id, type, created, lastUpdated, lastMembershipUpdated and profile (name, description). Use okta_group_get when you know the group ID. Use okta_groups_list to find it.

    Inputs

    group_idstringrequired
    Okta group ID (starts with 00g). Get it from okta_groups_list. Example: 00g1a2b3c4d5e6f7g8h9
  • okta_group_members_listList the users who are members of an Okta group.Read-only

    List Group Members

    List the users who are members of an Okta group. Returns user objects with id, status and profile (login, email, firstName, lastName). Use okta_group_members_list for one group's users. Use okta_user_groups_list for one user's groups.

    Inputs

    group_idstringrequired
    Okta group ID (starts with 00g). Get it from okta_groups_list. Example: 00g1a2b3c4d5e6f7g8h9
    afterstring
    Pagination cursor for the next page. Okta puts it in the after parameter of the rel="next" Link response header; for group members Okta uses the id of the last item on the previous page. Leave empty for the first page. Example: 00u1a2b3c4d5e6f7g8h9
    limitinteger
    Maximum number of results to return in this page. Okta default is 1000. Example: 200
  • okta_groups_listList or search groups in the Okta org by name prefix, filter expression or search expression.Read-only

    List Groups

    List or search groups in the Okta org by name prefix, filter expression or search expression. Returns group objects with id, type (OKTA_GROUP, APP_GROUP, BUILT_IN), created and profile (name, description). Use okta_groups_list to find groups or their IDs. Use okta_group_get for one group by ID.

    Inputs

    afterstring
    Pagination cursor for the next page. Okta puts it in the after parameter of the rel="next" Link response header; for groups Okta uses the id of the last item on the previous page. Leave empty for the first page. Example: 00g1a2b3c4d5e6f7g8h9
    filterstring
    Okta filter expression on id, type, lastUpdated or lastMembershipUpdated. Example: type eq "APP_GROUP"
    limitinteger
    Maximum number of results to return in this page. Okta's default depends on the org. Okta recommends a value of 10000 or less. Example: 100
    qstring
    Finds groups whose name starts with this text. Returns at most 300 results and does not page. Do not combine with search. Example: Engineering
    searchstring
    Okta search expression over group properties, including profile attributes and type. Example: type eq "OKTA_GROUP" and profile.name sw "Eng"
  • okta_system_log_events_listList Okta System Log events, such as sign-ins, MFA challenges, admin changes and app access, within a time range.Read-only

    List System Log Events

    List Okta System Log events, such as sign-ins, MFA challenges, admin changes and app access, within a time range. Returns events with uuid, published, eventType, displayMessage, severity, actor, client, outcome and target. Use okta_system_log_events_list to audit activity. Narrow it with since, until, filter or q.

    Inputs

    afterstring
    Opaque pagination cursor from the after parameter of the rel="next" Link response header. To read further, prefer narrowing since and until. Example: 1731628800000_1
    filterstring
    Okta filter expression on event properties. Example: eventType eq "user.session.start" and outcome.result eq "FAILURE"
    limitinteger
    Maximum number of results to return in this page. Okta default is 100. Maximum is 1000. Example: 100
    qstring
    Case-insensitive keywords to match anywhere in the event, separated by spaces. Example: jane.doe@example.com
    sincestring
    Start of the time range, as an ISO 8601 timestamp. Okta defaults to 7 days before until and keeps logs for 90 days. Example: 2026-11-01T00:00:00Z
    sort_orderstring
    Order of events by published time. Okta default is ASCENDING. Example: DESCENDINGone of ASCENDINGDESCENDING
    untilstring
    End of the time range, as an ISO 8601 timestamp. Defaults to now. Example: 2026-11-15T00:00:00Z