View as Markdown
Okta icon

Okta ACTION

Create User

Creates a new user in the Okta system. See the documentation
  • Action
  • Writes data
  • API key
  • SDK
  • MCP

IMPLEMENTATION

Call this tool

Connect a user's Okta account once, then configure and run Create User from your backend or agent.

import { PipedreamClient } from "@pipedream/sdk"

const pd = new PipedreamClient({
  projectId: process.env.PIPEDREAM_PROJECT_ID!,
  clientId: process.env.PIPEDREAM_CLIENT_ID!,
  clientSecret: process.env.PIPEDREAM_CLIENT_SECRET!,
  projectEnvironment: "production",
})

const result = await pd.actions.run({
  id: "okta-create-user",
  externalUserId: "{external_user_id}", // any stable ID for this user in your system
  configuredProps: {
    okta: { authProvisionId: "apn_xxxxxxx" },
    activate: true,
    firstName: "First Name",
  },
})

console.log(result)

SCHEMA

Inputs

Pipedream supplies the connected account. Your application provides the operation-specific values below. Dynamic inputs are resolved against that user's account.

Create User inputs
Property Type Description
activate Activate boolean
Executes activation lifecycle operation when creating the user. Defaults to true.
Optional
firstName First Name string
The first name of the user.
Required
lastName Last Name string
The last name of the user.
Required
email Email string
The email address of the user.
Required
login Login string
The login for the user.
Required
mobilePhone Mobile Phone string
The mobile phone number of the user.
Optional
typeId Type Id string
The ID of the user type. Add this value if you want to create a user with a non-default user type. The user type determines which schema applies to that user. After a user has been created, the user can only be assigned a different user type by an administrator through a full replacement (PUT) operation.
Optional Dynamic

REFERENCE

Tool details

Behavior hints are published with the component in the Pipedream registry and surface as MCP tool annotations, so an agent can reason about a tool before it calls it.

Registry key
okta-create-user
Version
0.0.2
App
Okta
Authentication
API key
Read-only
No
Destructive
No
Open world
Yes