Find Matching Object

The Find Matching Object action searches a list using one property path and a configurable comparison. Return the first match for lookup workflows, or all matches for filtering workflows.

Inputs

Input	Type	Required	Description
Objects	List of objects	Yes	The objects to search, in priority order.
Property Name	String	Yes	The top-level key or nested path whose value is tested.
Match Mode	Match mode	Yes	The comparison to perform. Defaults to Exact Value.
Search Value	Varies	Sometimes	Required by value, text, regex, and numeric modes.
Find Multiple Objects?	Boolean	No	Returns every match instead of only the first. Defaults to `false`.

Outputs

First match
Multiple matches

Output	Type	Description
Found Object	Object	The first matching object in input order.

When nothing matches, no object value is found.

Output	Type	Description
Found Objects	List of objects	Every matching object in input order.

Match modes

Mode	Search Value	A property matches when…
Exact Value	Any	It is loosely equal to the search value.
Empty	None	It is exactly an empty string.
Not Empty	None	It is anything other than an empty string.
Contains Text	String	Its text form contains the search text, ignoring case.
Matches Regex	Regular expression	Its text form matches the pattern.
Greater Than	Number	It is a number greater than the search value.
Less Than	Number	It is a number less than the search value.
Greater Than or Equal	Number	It is a number at least as large as the search value.
Less Than or Equal	Number	It is a number no larger than the search value.
Is True	None	It is the boolean `true`.
Is False	None	It is the boolean `false`.
Is Truthy	None	JavaScript treats it as truthy.
Is Falsy	None	JavaScript treats it as falsy.

Property Name supports paths such as customer.plan and items[0].quantity.

Important comparison details

Exact Value uses loose primitive equality, so the number 42 can match the text "42", and null can match a missing value.
Empty matches only empty text. It does not match null, missing properties, empty objects, or empty lists.
Consequently, Not Empty also matches missing properties and non-string values.
Contains Text converts objects and lists to JSON text and compares without case sensitivity.
Numeric modes require the property itself to be a number.
Falsy values include false, 0, empty text, null, and missing values.

For Matches Regex, turn off the regex’s Global flag. Reusing a global regex across several objects can advance its internal match position and skip otherwise valid matches.

Overview

Fundamentals

Web, Files & Data

AI

Scraping & Rendering

Google Workspace

Email, CRM & Scheduling

Databases & Tables

Microsoft

Inputs

Outputs

Match modes

Important comparison details

​Inputs

​Outputs

​Match modes

​Important comparison details

Inputs

Outputs

Match modes

Important comparison details