Skip to content

Monday Search Items

The Monday Search Items node performs a filtered search for items within a specified Monday.com board based on provided search conditions.

Purpose

Use this node to programmatically search for Monday.com items matching specific criteria, returning results for reporting, validation, or subsequent automated actions.

Inputs

Field LabelInput TypeDescription
Board IdTextThe ID of the Monday.com board to search within.
Search QueryJSONA JSON array of search conditions (SearchStringCompare) specifying the filters to apply (e.g. [{"ColumnId":"status","Value":"Done"}]).

Outputs

Output VariableDescription
MondayItemsThe list of items matching the search conditions, returned as a MondayFlatItems object.

Functionality

This node:

  1. Validates required inputs (Board Id, Search Query).
  2. Retrieves the Monday.com service account token.
  3. Parses the search conditions from the Search Query JSON.
  4. Searches the specified board for items matching the conditions using the Monday API.
  5. Stores the retrieved items in MondayItems for use in subsequent workflow tasks.

Example Use Case

✅ Retrieve all items with a status of "In Progress" to send reminder notifications.
✅ Search for tasks assigned to a specific user for inclusion in automated status reports.

Task Success Criteria

  • Success: Items matching the search conditions are retrieved from Monday.com and stored as MondayItems.
  • Failure: If board ID is invalid, search query parsing fails, or the API call fails, the task returns a descriptive error message indicating the failure point.

Notes

  • Ensure the ServiceAccount-Monday service account is configured with valid credentials and has access to the target board.
  • The Search Query input must be a valid JSON array of SearchStringCompare conditions specifying column IDs and their desired values.
  • The output (MondayItems) contains all items meeting the search criteria, ready for use in updates, reporting, or conditional branching within the workflow.

Tentech 2024