Worktables icon

Worktables

Interact with Monday.com boards and items

Actions26

Overview

This node enables interaction with Monday.com boards and their components via the Monday.com API. Specifically, for the Board resource and the Create a Group operation, it allows users to create a new group within an existing board. This is useful for organizing items on a board into logical sections or categories.

Typical use cases include:

  • Structuring project boards by adding groups such as "To Do", "In Progress", and "Done".
  • Dynamically creating groups based on workflow automation needs.
  • Organizing tasks or items in a board programmatically during integration workflows.

Example: Automatically add a new group named "Q3 Planning" with a specific color to a project board when a new quarter starts.

Properties

Name Meaning
Workspace Name or ID Select the workspace where the target board resides. You can choose from a list or specify an ID using an expression.
Board Name or ID Select the Monday.com board where the new group will be created. Choose from the list or specify an ID using an expression.
Group Name The name of the new group to create on the selected board.
Group Color The color assigned to the new group. Options include: Grey, Working Orange, Done Green, Stuck Red, Dark Blue, Purple, Grass Green, Bright Blue, Saladish, Egg Yolk, Dark Red, Sofia Pink, Lipstick, Dark Purple, Bright Green, Chili Blue, American Grey, Brown, Dark Orange.
Relative To Group Name or ID Select an existing group on the board relative to which the new group will be positioned. Choose from the list or specify an ID using an expression.
Position Relative Defines whether the new group will be created before (above) or after (below) the specified relative group. Options: Before, After.

Output

The output JSON contains the newly created group's details as returned by the Monday.com API. It includes at least:

  • id: The unique identifier of the created group.
  • title: The title/name of the created group.

No binary data output is involved in this operation.

Example output structure:

{
  "data": {
    "create_group": {
      "id": "group_id_value",
      "title": "Group Name"
    }
  }
}

Dependencies

  • Requires an active Monday.com API key credential configured in n8n.
  • Uses Monday.com GraphQL API endpoint: https://api.monday.com/v2.
  • The node depends on proper permissions for the API key to create groups on boards.

Troubleshooting

  • API Key Not Found: Ensure that the Monday.com API key credential is correctly set up and linked to the node.
  • Board ID Required: The operation requires a valid board ID; ensure the board is selected or the ID is correctly provided.
  • Group ID Required for Relative Positioning: When specifying the position relative to another group, the relative group ID must be valid and exist on the board.
  • Invalid Group Color: Use one of the predefined color options; custom colors are not supported.
  • Permission Errors: The API key must have sufficient permissions to modify the board and create groups.
  • Network or API Errors: Check network connectivity and Monday.com service status if requests fail.

Links and References

Discussion