Worktables icon

Worktables

Interact with Monday.com boards and items

Actions26

Overview

The 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 organizational structure of a board, such as its groups, to automate workflows that depend on group data.

Common scenarios include:

  • Automating reporting or synchronization tasks that require knowledge of board groups.
  • Dynamically fetching groups to use in subsequent automation steps (e.g., creating items in specific groups).
  • Managing board structures by listing groups before performing updates or duplications.

Example: You have a Monday.com board representing projects, and each group represents a project phase. Using this node operation, you can list all phases (groups) to trigger different automations based on the phase.

Properties

Name Meaning
Workspace Name or ID Select the workspace containing the board. Choose from the list or specify an ID via expression.
Board Kind Filter boards by kind: All, Public, Private, or Shareable.
Order By The order in which to retrieve boards/groups: None, Name (created_at), or Newest (used_at).
State Filter boards by state: All, Active, Archived, or Deleted.
Limit Maximum number of results to return. If 0, all results are returned.
Board Name or ID Select the specific board to list groups from. Choose from the list or specify an ID via expression.
Archived Whether to include archived groups in the list (boolean).
Deleted Whether to include deleted groups in the list (boolean).

Output

The output JSON contains the list of groups for 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): Indicates if the group is archived (present if requested).
  • deleted (optional): Indicates if the group is deleted (present if requested).

The output is structured as an array of these group objects under the groups field inside the board data.

No binary data is output by this operation.

Dependencies

  • Requires an API key credential for Monday.com with appropriate permissions.
  • The node makes HTTP POST requests to the Monday.com GraphQL API endpoint at https://api.monday.com/v2.
  • The user must configure the node with valid credentials and select or provide IDs for workspace and board.

Troubleshooting

  • API Key not found: Ensure the API key credential is configured correctly in n8n.
  • Board ID is required: The operation requires a valid board ID; ensure it is selected or provided.
  • Empty or no groups returned: Verify the board has groups and that filters like archived/deleted are set appropriately.
  • Permission errors: The API key must have sufficient permissions to read board groups.
  • Network or API errors: Check network connectivity and Monday.com API status.

Links and References

Discussion