Bulk User Import

Update an in progress import session in Okta by creating or updating users in Okta.

A maximum of 10,000 users per session can be imported.

Scopes

See Action cards for the list of required OAuth scopes for this card.

Options

Field Definition Type Required

Application

Dynamically return all Custom Identity Source integration apps. This field also provides an option to enter the app ID as an input field.

The field displays a maximum of 100 app instances. If a timeout occurs due to server or network issues, the field displays -- Enter Application ID --.

 Dropdown TRUE

Import Operation

Choose an import operation type:

  • Create & Update: Create and update users. Returns a list of objects that contain an external ID and a profile object.

  • Deactivate & Delete: Deactivate and delete users. Returns a list of external ID objects.

 Dropdown TRUE

Input

Field Definition Type Required

Application

ID

The unique identifier of a Custom Identity Source app.

This appears when -- Enter Application ID -- is selected from the Application option.

 Text TRUE

ID

The unique identifier of an active or in-progress import session. You can retrieve this value from the resulting Session ID output of the Create an Import Session card.

 Text TRUE

Bulk Import

Users Per Page

The number of users in a list per one import request.

  • The default value is 200.

  • The valid range is from 1 to 200.

  • When the field value is within the valid range and has a decimal part, it's converted to the nearest greater integer value.

    For example, 0.001 is converted to 1, and 199.01 is converted to 200.

  • When the field isn't selected, the default value is used.

  • When the field is set to 0 or less, the card returns an error.

  • The card returns an error if the number of users in the list divided by the field value is greater than 50.

 Number FALSE

Data

Users

A list of user profile objects to import.

This field displays custom properties when Create & Update is selected from the Import Operation option. See the Okta Profile object API documentation.

 List of Objects FALSE

External ID

The unique external ID to associate orgs to an external record.

 Object FALSE

Profile

The profile of the user.

 Object FALSE

User Name

The username of the user.

 Object FALSE

First Name

First name of the user.

 Object FALSE

Last Name

The family name of the user.

 Object FALSE

Email

The email address of the user.

 Object FALSE

Second Email

A second email address of the user.

 Object FALSE

Mobile Phone

The mobile number of the user.

 Object FALSE

Home Address

The address of the user.

 Object FALSE

Custom Properties

Other custom properties that are generated when configuring this card.

 Object FALSE

Output

Field Definition Type

Response

Records Imported

The number of user records successfully imported.