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.

Note:

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 for this card.

Options

Field Definition Type Required

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

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

Note:

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

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@asqula.com` are all valid.	Text	FALSE

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@asqula.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` Note: 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