Actions29
- Board Actions
- Item Actions
- Update Actions
- Team Actions
- User Actions
- Query Actions
Overview
This node interacts with Monday.com boards and their components via the Monday.com API. Specifically, for the Board resource and the List Board's Groups operation, it retrieves all groups within a specified board. This is useful when you want to programmatically access the structure of a board, such as its groups, to automate workflows that depend on group data.
Common scenarios:
- Automating reporting or synchronization tasks that require knowledge of board groups.
- Dynamically fetching groups to populate dropdowns or options in subsequent workflow steps.
- Integrating Monday.com board structures into other systems or dashboards.
Example:
You have a Monday.com board representing a project with multiple groups (e.g., "To Do", "In Progress", "Done"). Using this node operation, you can list all these groups and then perform actions like creating items in specific groups or analyzing group statuses.
Properties
| Name | Meaning |
|---|---|
| Workspace Name or ID | Select the workspace containing the board. You can choose from a list or specify an ID via expression. Required. |
| Board Kind | Filter boards by kind when listing boards or groups. Options: All, Public, Private, Shareable. Default is "all". |
| Order By | The order in which to retrieve boards/groups. Options: None, Name (created_at), Newest (used_at). Default is "none". |
| State | Filter boards by state. Options: All, Active, Archived, Deleted. Default is "active". |
| Limit | Maximum number of results to return. If set to 0, all results are returned. Default is 50. |
| Board Name or ID | Select the specific board to list groups from. Choose from the list or specify an ID via expression. Required. |
| Archived | Boolean flag indicating whether to include archived groups in the list. Default is false. |
| Deleted | Boolean flag indicating whether to include deleted groups in the list. Default is false. |
Output
The output JSON contains an array of group objects belonging to the specified board. Each group object includes:
id: The unique identifier of the group.title: The name/title of the group.color: The color assigned to the group.position: The position/order of the group within the board.archived(optional): Whether the group is archived (if requested).deleted(optional): Whether the group is deleted (if requested).
This structured data allows downstream nodes or processes to understand the grouping structure of the board.
Dependencies
- Requires an API key credential for Monday.com with appropriate permissions to read board and group information.
- The node makes HTTP POST requests to the Monday.com GraphQL API endpoint at
https://api.monday.com/v2. - No additional external dependencies beyond the Monday.com API and n8n environment.
Troubleshooting
- API Key Not Found: The node will throw an error if the API key credential is missing or invalid. Ensure the credential is configured correctly in n8n.
- Board ID Required: If the board ID is not provided or invalid, the node will error out. Make sure to select or provide a valid board ID.
- Permission Errors: If the API key does not have sufficient permissions to access the board or groups, the request will fail. Verify API token scopes.
- Empty Results: If no groups are returned, verify that the board has groups and that filters like archived/deleted flags are set appropriately.
- Rate Limits: Monday.com API rate limits may cause errors if too many requests are made in a short time. Implement retry logic or reduce request frequency if needed.