Find Users

Search Okta users with a query. The query performs a starts with match against First Name, Last Name, or Email. You can either display the first record that matches or a list of all of the matching records (up to 200). See Find users for more information about searching users.

Options

Field Definition Type Required
Result Set

Choose one of the following options to display your search results:

  • First Matching Record: returns a single record

  • All Matching Records: returns all matching records, in list format

Dropdown FALSE
Caution

When using the All Matching Records option, a maximum of 10,000 users are returned in any search result. This limit helps ensure proper system performance. However, additional custom user properties or other user data in the result set may cause a flow to exceed system limitations unexpectedly and cause an out-of-memory error to occur.

Input

Field Definition Type Required
Query The query string used to find records by first name, last name, or email address. For example, to search for Bob Ross, Bob, Ross, bob.ross@okta.com are all valid query terms. String FALSE

Output

Field Definition Type
First Matching Record
Raw Body Raw payload returned from the Okta API. Object
ID ID of the user created in Okta. String
Status Current status of the user: STAGED, PROVISIONED, ACTIVE, RECOVERY, LOCKED_OUT, PASSWORD_EXPIRED, SUSPENDED, or DEPROVISIONED. String
Created Timestamp when the user was created. Date & Time
Activated Timestamp when the transition to ACTIVE status completed. Boolean
Status Changed Date of the last user status change. Date & Time
Last Login Timestamp of the user's last login date. Date & Time
Last Updated Timestamp of the user's last update. Date & Time
Password Changed Timestamp of the user's last password change. Date & Time
First Name User's first name. String
Last Name User's last name or family name. String
Mobile Phone User's mobile phone number. String
Second Email Secondary email address of the user (typically used for account recovery). String
Login Login username of the user (usually in the form of an email address). String
Email User's primary email address. String
All Matching Records
Users A list of all matching users with a payload similar to above. List of Objects

Related topics

Okta connector

About the elements of Okta Workflows

Okta API