Find Users

Search Okta users with a query. The query performs a startsWith match against a user's first name, family name, or email address. It displays the first record that matches or the first 200 matching records.

If you pass nothing into the card, it returns a random user because of the startsWith wildcard matching.

See Find Users in the Okta API documentation.

This card displays either the first record that matches, the first 200 matching records, or it can stream all matching records.

Options

Field Definition Type Required
Result Set Choose a method to filter search results:
  • First Matching Record: returns a single record.
  • First 200 Matching Records: returns the first 200 matching records.
Dropdown TRUE

To learn how to return a large number of records, see Set up the stream matching option with a helper flow.

Input

Field Definition Type Required
Query

A query string used to find records by first name, family name, or email address.

For example, to search for Bob Ross, the query terms Bob, Ross, or bob.ross@okta.com are all valid.

Text FALSE
Search Criteria
Record Limit

Specify the number of records to stream.

  • When the Limit field is set to 0, no records are returned.

  • When the Limit field is set to greater than 0, records greater than 0 and up the maximum number of records specified are returned.

  • When the Limit field is empty or not selected, all records are streamed.

  • Default value is 10 million.

  • Valid range is 0 to 10 million.

Appears when Stream Matching Records is selected from the Result Set option.

Number FALSE

Output

When selected from the Result Set option, both First Matching Record and First 200 Matching Records display the following fields.

Field Definition Type
Users

This field appears when you select First 200 Matching Records from the Result Set field.

Fields that appear under Users are helper fields.

List of Objects
Raw Output Raw payload returned from the Okta API. Object
ID ID of the user created in Okta. Text
Status

Status of the user. A user profile can be in one of these states:

  • STAGED

  • PROVISIONED

  • ACTIVE

  • RECOVERY

  • LOCKED_OUT

  • PASSWORD_EXPIRED

  • SUSPENDED

When the status of a user is set to DEPROVISIONED, this card doesn't return parameters. Instead, use the List Users With Search or List Users with Filter cards.

Text
Created Timestamp when the user was created. Date & Time
Activated Timestamp when the transition to ACTIVE status completed. True/False
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 First name of the user. Text
Last Name User's last name or family name. Text
Mobile Phone Mobile phone number of the user. Text
Second Email Secondary email address of the user (typically used for account recovery). Text
Login Login username of the user (usually in the form of an email address). Text
Email

Email address of the user.

This field appears when you select First 200 Matching Records in the Result Set field.

Text

Related topics

Okta connector

Elements of Workflows

Guidance for Okta connector

Okta API documentation