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
- API key
Setup
Install the SDK
Terminal window npm install @scalekit-sdk/node dotenvTerminal window pip install scalekit-sdk-python python-dotenvSet your credentials
Add your Scalekit credentials to your
.envfile. 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>Create the Okta connection
In AgentKit > Connections, create an Okta connection. The name you give it is the
connection_nameyour code passes. See Configure connections.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.actionsconst connector = 'okta'const identifier = 'user_123'// Generate an authorization link for the userconst { 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 callconst result = await actions.executeTool({connector,identifier,toolName: 'okta_apps_list',toolInput: {},})console.log(result)Terminal window npx tsx quickstart.mtsquickstart.py import osfrom scalekit import ScalekitClientfrom dotenv import load_dotenvload_dotenv()scalekit_client = ScalekitClient(env_url=os.getenv("SCALEKIT_ENVIRONMENT_URL"),client_id=os.getenv("SCALEKIT_CLIENT_ID"),client_secret=os.getenv("SCALEKIT_CLIENT_SECRET"),)actions = scalekit_client.actionsconnection_name = "okta"identifier = "user_123"# Generate an authorization link for the userlink_response = actions.get_authorization_link(connection_name=connection_name,identifier=identifier,)print("Authorize Okta:", link_response.link)input("Press Enter after authorizing...")# Make your first callresult = actions.execute_tool(tool_input={},tool_name="okta_apps_list",connection_name=connection_name,identifier=identifier,)print(result)Terminal window python quickstart.pyEach 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 toexecute_toolokta_app_getGet one Okta application by ID.Read-onlyGet 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-onlyList 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-onlyList 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-onlyList 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-onlyGet 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-onlyList 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-onlyList 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-onlyList 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
okta_user_app_links_listList the apps assigned to an Okta user, as shown on their Okta dashboard.Read-onlyList User App Links
List the apps assigned to an Okta user, as shown on their Okta dashboard. Returns app links with appInstanceId, appName, label, linkUrl and hidden. Use okta_user_app_links_list for one user's apps. Use okta_app_users_list for the users of one app.
Inputs
user_idstringrequired- Okta user ID, login (username) or unambiguous login short name of the user. Get the ID from okta_users_list. Example: 00u1a2b3c4d5e6f7g8h9 or jane.doe@example.com
okta_user_factors_listList the MFA factors an Okta user has enrolled, such as Okta Verify, SMS, email or WebAuthn.Read-onlyList User Factors
List the MFA factors an Okta user has enrolled, such as Okta Verify, SMS, email or WebAuthn. Returns factor objects with id, factorType, provider, vendorName, status and profile. Use okta_user_factors_list to check a user's MFA enrollment.
Inputs
user_idstringrequired- Okta user ID (starts with 00u). Get it from okta_users_list or okta_user_get. Example: 00u1a2b3c4d5e6f7g8h9
okta_user_getGet one Okta user by ID or login.Read-onlyGet User
Get one Okta user by ID or login. Returns id, status, created, activated, lastLogin, passwordChanged, profile and credentials.provider. Use okta_user_get when you know the user's ID or login. Use okta_users_list to search.
Inputs
user_idstringrequired- Okta user ID, login (username) or unambiguous login short name of the user. Get the ID from okta_users_list. Example: 00u1a2b3c4d5e6f7g8h9 or jane.doe@example.com
okta_user_groups_listList the groups an Okta user belongs to.Read-onlyList User Groups
List the groups an Okta user belongs to. Returns group objects with id, type and profile (name, description). Use okta_user_groups_list for one user's groups. Use okta_group_members_list for the users in one group.
Inputs
user_idstringrequired- Okta user ID, login (username) or unambiguous login short name of the user. Get the ID from okta_users_list. Example: 00u1a2b3c4d5e6f7g8h9 or jane.doe@example.com
okta_users_listList or search users in the Okta org, with a simple name/email query, a filter expression or a search expression.Read-onlyList Users
List or search users in the Okta org, with a simple name/email query, a filter expression or a search expression. Returns user objects with id, status, created, lastLogin and profile (login, email, firstName, lastName). Use okta_users_list to find users or their IDs. Use okta_user_get for one user by ID or login. Use okta_group_members_list for users in one group.
Inputs
afterstring- Pagination cursor for the next page. Okta puts it in the after parameter of the rel="next" Link response header; for users Okta uses the id of the last item on the previous page. Leave empty for the first page. Example: 00u1a2b3c4d5e6f7g8h9
filterstring- Okta filter expression on a limited set of properties: status, lastUpdated, id, profile.login, profile.email, profile.firstName, profile.lastName. Only the eq operator (and gt/lt for lastUpdated). Use search for anything else. Example: status eq "SUSPENDED"
limitinteger- Maximum number of results to return in this page. Okta default is 200 (10 when q is used). Maximum is 200. Example: 50
qstring- Simple text lookup that matches the beginning of firstName, lastName or email. Best for a quick name or email lookup; returns at most 10 results unless limit is set and does not page. Do not combine with search. Example: jane
searchstring- Okta search expression over most user properties, including custom profile attributes; Okta recommends it over filter. Uses SCIM-style operators (eq, sw, co, gt, lt, pr, and, or). Example: profile.department eq "Engineering" and status eq "ACTIVE"
sort_bystring- Property to sort by. Works only together with search. Example: profile.lastName
sort_orderstring- Sort direction, asc or desc. Ignored unless sort_by is set. Example: ascone of
ascdesc
okta_group_createCreate an Okta group (type OKTA_GROUP) with a name and optional description.WriteCreate Group
Create an Okta group (type OKTA_GROUP) with a name and optional description. Returns the new group with id, type and profile. Use okta_group_create for a new group, then okta_group_member_add to add users.
Inputs
namestringrequired- Group name, unique in the org. Example: Engineering - Backend
descriptionstring- Group description. Example: Backend engineers with access to production tools
okta_group_member_addAdd an Okta user to an OKTA_GROUP group.WriteAdd Group Member
Add an Okta user to an OKTA_GROUP group. Returns an empty response on success; adding an existing member has no effect. Use okta_group_member_add to grant group membership. Use okta_group_member_remove to revoke it.
- Idempotent
Inputs
group_idstringrequired- Okta group ID (starts with 00g). Get it from okta_groups_list. Example: 00g1a2b3c4d5e6f7g8h9
user_idstringrequired- Okta user ID (starts with 00u). Get it from okta_users_list or okta_user_get. Example: 00u1a2b3c4d5e6f7g8h9
okta_group_updateReplace the name and description of an OKTA_GROUP group.WriteUpdate Group
Replace the name and description of an OKTA_GROUP group. App-imported groups (APP_GROUP) cannot be changed. Returns the updated group. Use okta_group_update to rename a group. A description you leave empty is cleared.
- Idempotent
Inputs
group_idstringrequired- Okta group ID (starts with 00g). Get it from okta_groups_list. Example: 00g1a2b3c4d5e6f7g8h9
namestringrequired- New group name. Example: Engineering - Platform
descriptionstring- New group description. Leaving it empty clears the current description, because this replaces the whole profile. Example: Platform engineering team
okta_user_activateActivate a STAGED or DEPROVISIONED Okta user, optionally emailing them an activation link.WriteActivate User
Activate a STAGED or DEPROVISIONED Okta user, optionally emailing them an activation link. Returns activationUrl and activationToken when send_email is false, otherwise an empty object. Use okta_user_activate for new or deactivated users. Use okta_user_unsuspend for a SUSPENDED user.
Inputs
user_idstringrequired- Okta user ID, login (username) or unambiguous login short name of the user. Get the ID from okta_users_list. Example: 00u1a2b3c4d5e6f7g8h9 or jane.doe@example.com
send_emailboolean- Whether Okta emails the user an activation link. Okta default is true. Set false to get the activation URL back instead. Example: false
okta_user_createCreate a user in the Okta org, optionally with a password and group memberships, and optionally activate them.WriteCreate User
Create a user in the Okta org, optionally with a password and group memberships, and optionally activate them. Returns the new user with id, status (STAGED, PROVISIONED or ACTIVE) and profile. Use okta_user_create for a new person. Use okta_user_update to change an existing user.
Inputs
emailstringrequired- User's primary email address. Example: jane.doe@example.com
first_namestringrequired- User's given name. Example: Jane
last_namestringrequired- User's family name. Example: Doe
activateboolean- Whether to activate the user now. true (Okta default) activates and sends an activation email when no password is set; false creates the user in STAGED status. Example: false
departmentstring- User's department. Example: Engineering
group_idsarray- IDs of Okta groups to add the user to at creation, up to 20. Get IDs from okta_groups_list. Example: ["00g1a2b3c4d5e6f7g8h9"]
loginstring- Unique username, in email format by default. Defaults to the email when left empty. Example: jane.doe@example.com
mobile_phonestring- User's mobile phone number. Example: +1-555-415-1337
passwordstring- Initial password. Must meet the org's password policy. Leave empty to create a user who sets a password through the activation email. Example: Tlpe$2026xQ!
profileobject- Other Okta profile attributes to set, as a JSON object of attribute name to value. Standard attributes include city, countryCode, displayName, employeeNumber, manager, managerId, organization and secondEmail; custom attributes from your org's user schema also work. These are merged into the profile and override the fields above. Example: {"employeeNumber": "1042", "city": "San Francisco"}
titlestring- User's job title. Example: Software Engineer
okta_user_suspendSuspend an ACTIVE Okta user so they cannot sign in, keeping their app assignments.WriteSuspend User
Suspend an ACTIVE Okta user so they cannot sign in, keeping their app assignments. Returns an empty response on success; status becomes SUSPENDED. Use okta_user_suspend for a temporary block. Use okta_user_unsuspend to restore. Use okta_user_deactivate to offboard.
Inputs
user_idstringrequired- Okta user ID, login (username) or unambiguous login short name of the user. Get the ID from okta_users_list. Example: 00u1a2b3c4d5e6f7g8h9 or jane.doe@example.com
okta_user_unsuspendReturn a SUSPENDED Okta user to ACTIVE so they can sign in again.WriteUnsuspend User
Return a SUSPENDED Okta user to ACTIVE so they can sign in again. Returns an empty response on success. Use okta_user_unsuspend after okta_user_suspend. Use okta_user_activate for STAGED or DEPROVISIONED users.
Inputs
user_idstringrequired- Okta user ID, login (username) or unambiguous login short name of the user. Get the ID from okta_users_list. Example: 00u1a2b3c4d5e6f7g8h9 or jane.doe@example.com
okta_user_updateUpdate an Okta user's profile, changing only the attributes you pass.WriteUpdate User
Update an Okta user's profile, changing only the attributes you pass. Returns the updated user with id, status and full profile. Use okta_user_update to edit profile fields. Use okta_user_activate, okta_user_deactivate or okta_user_suspend to change status.
- Idempotent
Inputs
user_idstringrequired- Okta user ID, login (username) or unambiguous login short name of the user. Get the ID from okta_users_list. Example: 00u1a2b3c4d5e6f7g8h9 or jane.doe@example.com
departmentstring- New department. Example: Engineering
emailstring- New primary email address. Example: jane.smith@example.com
first_namestring- New given name. Example: Jane
last_namestring- New family name. Example: Smith
loginstring- New unique username. Example: jane.smith@example.com
mobile_phonestring- New mobile phone number. Example: +1-555-415-1337
profileobject- Other profile attributes to change, as a JSON object of attribute name to value; standard or custom attributes. Attributes you leave out keep their current value. Example: {"city": "Austin", "managerId": "00u9z8y7x6w5v4u3t2s1"}
titlestring- New job title. Example: Engineering Manager
okta_group_member_removeRemove an Okta user from an OKTA_GROUP group.DestructiveRemove Group Member
Remove an Okta user from an OKTA_GROUP group. Returns an empty response on success. The user may lose apps assigned through this group. Use okta_group_member_remove to revoke membership. Use okta_group_member_add to grant it.
- Idempotent
Inputs
group_idstringrequired- Okta group ID (starts with 00g). Get it from okta_groups_list. Example: 00g1a2b3c4d5e6f7g8h9
user_idstringrequired- Okta user ID (starts with 00u). Get it from okta_users_list or okta_user_get. Example: 00u1a2b3c4d5e6f7g8h9
okta_user_deactivateDeactivate an Okta user, which sets status to DEPROVISIONED and removes them from all assigned apps.DestructiveDeactivate User
Deactivate an Okta user, which sets status to DEPROVISIONED and removes them from all assigned apps. Returns an empty response on success. This cannot be undone without reactivating the user, and app data may be lost. Use okta_user_deactivate to offboard. Use okta_user_suspend to block sign-in temporarily.
Inputs
user_idstringrequired- Okta user ID, login (username) or unambiguous login short name of the user. Get the ID from okta_users_list. Example: 00u1a2b3c4d5e6f7g8h9 or jane.doe@example.com
send_emailboolean- Whether Okta emails the org admins about the deactivation. Okta default is false. Example: false
No tools match.