List Custom Fields

Retrieve a list of custom fields from SmartHR.


Field Definition Type Required
Result Set

Choose one of the following options to return your results:

  • First 100 Records: Returns the first 100 matching records.

  • Stream Records: Passes all matching user records from your parent flow to a helper flow. Adds a Streaming input section to the card where you can select a helper flow for streaming and adding custom extensible fields.

Dropdown TRUE

To learn how to return large numbers of records, see Stream matching records with a helper flow.


Field Definition Type Required

Click Choose Flow to browse and select a helper flow where 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.

This field appears when Stream Records is selected from the Result Set field.

The input field on the Helper Card in the streaming helper flow must reference the key Record (type object) to obtain streamed records. To obtain state input values, reference the key State (type object) of the Record object.

Record Limit

Specify the number of records to stream.

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

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

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

  • Default value is 500000.

  • Valid range is from 0 to 500000.

This field appears when Stream Records is selected from the Result Set option.

Number TRUE


Field Definition Type
Custom Fields Object
Custom Field ID Unique identifier for the custom field. Text
Name Custom field name. Text
Type Input type for the custom field. Text

Dropdown list options for enum input type.

  • Item ID (Text) - dropdown list item ID

  • Display name (Text) - list item name

  • Value (Text) - list item value

  • Position (Number) - list item position

Object (List)
Hint Input hint for the custom field. Text
Scale Significant digits for numeric values. Number
Separated by Commas Displays numeric values separated by commas every three digits. True/False
Position Custom field position. Number
Created At Date created. Date & Time
Updated At Last updated. Date & Time
Custom Field Groups

Custom field group associated with the custom field.

  • Custom Field Group ID (Text) - identifier for the custom field group

  • Name (Text) -name of the custom field group

  • Position (Number) - custom field position

  • Access Type (Text) - access type. Can be read_and_update, hidden, read_and_update_values, or read_and_update_only_origin

  • Created At (Date & Time) - date created

  • Updated At (Date & Time) - last updated

Records Streamed

Number of records streamed in a streaming flow.

This field appears when you select Stream Records from the Result Set option.


Related topics

SmartHR connector

Workflow elements

SmartHR API documentation