Find Users

Search Okta users using a query.

The query performs a startsWith match against a user's first name, last 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.

Scopes

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

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 Stream matching records with a helper flow.

Input

Field Definition Type Required

Query

A query string used to find records by first name, last 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

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

Fields that appear under Users are helper fields.

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

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

Time stamp when the user was created.

Date & Time

Activated

Time stamp when the transition to ACTIVE status completed.

True/False

Status Changed

Date of the last user status change.

Date & Time

Last Login

Time stamp of the user's last login date.

Date & Time

Last Updated

Time stamp of the user's last update.

Date & Time

Password Changed

Time stamp of the user's last password change.

Date & Time

First Name

First name of the user.

Text

Last Name

Last name of the user.

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

Sign-in 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 from the Result Set option.

Text

Related topics

Okta connector

Workflow elements

Guidance for Okta connector

Okta API documentation