Worktables icon

Worktables

Interact with Monday.com boards and items

Actions29

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 integrations.

Example: Automatically add a new group named "Urgent Tasks" with a red color below an existing group called "Backlog" on a specified board.

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 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. Default is Grey (#c4c4c4).
Relative To Group Name or ID The 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 (before_at), After (after_at). Default is Before.

Output

The output JSON contains the newly created group's details, specifically its id and title. For example:

{
  "data": {
    "create_group": {
      "id": "new_group_id",
      "title": "New Group Name"
    }
  }
}

This output confirms successful creation and provides identifiers for further operations.

Dependencies

  • Requires an API key credential for Monday.com with appropriate permissions to access and modify boards.
  • The node makes HTTP POST requests to the Monday.com GraphQL API endpoint at https://api.monday.com/v2.
  • The user must have access rights to the specified workspace and board.

Troubleshooting

  • API Key Not Found: If the API key credential is missing or invalid, the node will throw an error. Ensure that a valid API key is configured in n8n credentials.
  • Board ID Required: The operation requires a valid board ID. If not provided or invalid, an error will occur.
  • Group ID Required: The "Relative To Group Name or ID" property must be set to position the new group correctly; otherwise, the mutation may fail.
  • Invalid Group Color: Selecting a color outside the predefined options may cause errors.
  • Permission Issues: Insufficient permissions on the Monday.com account or board may result in authorization errors.
  • GraphQL Errors: Any syntax or data errors in the GraphQL mutation will be returned by the API and surfaced by the node.

To resolve these issues:

  • Verify API key validity and permissions.
  • Confirm all required fields are filled correctly.
  • Check that the referenced board and group IDs exist and are accessible.
  • Use the exact color values provided in the options.

Links and References

This summary focuses on the Board - Create a Group operation extracted from the provided source code and properties.

Discussion