Search Groups

Search for groups based on the properties specified in the search parameter. The input fields in this card are dynamically generated based on your instance group profile properties. See Search Groups for more information on searching groups.

Options

Field Definition Type Required
Result Set Choose a method to filter search results:
  • First Matching Record: returns the first record that matches.
  • First 200 Matching Records: returns the first 200 matching records.
  • Stream Matching Records: passes all matching records from your parent flow to a helper flow. A Streaming input section is added to the card from which you can select a helper flow for streaming and adding custom extensible fields.
 Dropdown TRUE
Tip

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

Input

Appears when First Matching Record or First 200 Matching Record are selected from Result Set unless otherwise stated.

Field Definition Type Required
ID ID of the group in Okta. String FALSE
Created Timestamp when the group was created. String FALSE
Last Updated Timestamp when the group's profile was last updated. String FALSE
Last Membership Updated Timestamp when the group's membership was last updated. String FALSE
Type Determines how the group's profile and memberships are managed. Select from the following:
  • OKTA_GROUP
  • APP_GROUP
  • BUILT_IN.
String FALSE
Name Name of the group. String FALSE
Description Description of the group. String FALSE
Custom Search Criteria Any custom search criteria you want to add. See Okta Developer documentation. String FALSE
Streaming
Flow Click Choose Flow to browse and select a helper flow to which the search results will be streamed, then click Choose to confirm.

Optionally, click the empty field under Click or drop here to create and add custom extensible fields that pass data to the helper flow. These fields are added as key/value pairs under the State output object in the helper flow.

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

 Flow TRUE
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

Field Definition Type
Raw Object Raw payload returned from the Okta API.

Appears if First Matching Record is selected from the Result Set option.

 Object
Groups Appears if First 200 Matching Records is selected from the Result Set field.

ID, Created, Last Updated, Last Membership Updated, Object Class, Type, Profile fields display for First Matching Records and First 200 Matching Records.
ID ID of the group in Okta. String
Created

Date and time when the object was created.

 String
Last Updated Timestamp of the last group update. String
Last Membership Updated Timestamp of the last update to the group's membership. String
Object Class Determiner of the group's profile. List of Text
Type
  • How the group's profile and memberships are managed; this is one of:
    • OKTA_GROUP
    • APP_GROUP
    • BUILT_IN.
    		String
    Profile
    Name

    Name of the group.

    		 String
    Description Description of the group. String
    Records Streamed

    Number of records streamed in a streaming flow.

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

    		 Number

    Related topics

    Okta connector

    Elements of Workflows

    Guidance for Okta connector

    Okta API documentation