Monday Get Items

The Monday Get Items node retrieves items or subitems from a Monday.com board based on the specified Board ID, Group Name, and optional Parent Item ID.

Purpose

Use this node to programmatically fetch items from Monday.com boards or subitems under a parent item for reporting, updates, or data-driven workflow automation.

Inputs

Field Label	Input Type	Description
Board Id	Text	The ID of the Monday.com board to retrieve items from.
Group Name	Text	The name of the group within the board from which to retrieve items.
Parent Item Id (optional)	Text	If provided, retrieves subitems under this parent item instead of board items.

Outputs

Output Variable	Description
MondayItems	The list of items retrieved from the specified board group (when Parent Item Id is not provided).
MondaySubItems	The list of subitems retrieved under the specified parent item (when Parent Item Id is provided).

Functionality

This node:

1. Validates required inputs (Board Id, Group Name).
2. Retrieves the Monday.com service account token.
3. Retrieves items or subitems:
   • If Parent Item Id is provided, retrieves subitems under that parent item.
   • Otherwise, retrieves items from the specified board group.
4. Stores the retrieved items or subitems in MondayItems or MondaySubItems accordingly for use in subsequent tasks.

Example Use Case

✅ Retrieve all tasks from a specific board group to generate a progress report.
✅ Retrieve subitems under a parent item representing a project phase to validate completion before approval.

Task Success Criteria

• Success: Items or subitems are retrieved successfully from Monday.com and stored in their respective output variables.
• Failure: If Board ID is invalid, group or parent item retrieval fails, or API calls fail, 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 permissions for the target boards and items.
• The outputs (MondayItems or MondaySubItems) are MondayFlatItems objects containing all retrieved item data as dictionaries for flexible downstream use.
• If both Board ID and Parent Item ID are provided, subitems under the parent are retrieved preferentially.