Search for Users using Custom Search Criteria in Okta Workflows

In this guide:

  1. Okta Workflows guides
  2. Search for users using custom search criteria
  3. Related Okta Workflows guides
  4. Okta Workflows resources

Okta Workflows guides

Okta Workflows guides are questions and answers from the community office hours, the #okta-workflows channel on MacAdmins Slack, and other places. Read all the other guides.

How to search for users using custom search criteria in Okta Workflows?

This guide will teach you how to search for users using custom search criteria in Okta Workflows.

Search for users using custom search criteria

The Okta – List Users with Search card has a Custom Search Criteria field. The Operators section lists the operators you can use.

List Users with Search card.

The Custom Search Criteria field uses the List all Users API search parameter.(There is also a filter parameter, and the Okta – List Users with Filter card uses it)

Okta recommends using this parameter for search for best performance. 

The API documents’ search parameter lists properties you can use in search.

This operation searches many properties:

  • Any user profile property, including custom-defined properties
  • The top-level properties idstatuscreatedactivatedstatusChanged, and lastUpdated
  • The User Type accessed as type.id

Examples

This card, in this example, uses the status eq “ACTIVE” search expression, which returns all the active users.

Search for active users.

The following examples search for either active or suspended users. The card will return users who are active and who are suspended.

Search for active or suspended users.

The following example uses the pr operator and returns users who have the profile.linkedInProfile field with a non-empty value. linkedInProfile is a custom user profile attribute.

Search for users who have a field present.

The following examples search for users who were created before (lt: less than) a specified date.

Search for users created before a date.

You will notice that the Last Login user field is unavailable when searching.

The following example shows how to search using the Last Login field.

Search for users with the last login before a date.

The List Users with Search card returns all users. The card passes the user list to the List—Filter card, which filters the list for users whose last login was before a specified date.

Okta Workflows resources

🍫 Get help from Workflows specialists during weekly community office hours.

📺 Learn from Workflows videos.

🛟 Ask questions and share your flows on the Okta Workflows community forum.

🙋🏻‍♀️ Get help from the community: join the #okta-workflows channel on MacAdmins Slack.

Leave a comment