Worktables

Interact with Monday.com boards and items

Actions26

Overview

This node enables interaction with Monday.com boards, specifically allowing users to create a new group within an existing board. Creating groups in Monday.com helps organize items into sections or categories on a board, which is useful for project management, task tracking, and workflow organization.

Typical use cases include:

Structuring a project board by adding new groups for different phases or teams.
Dynamically creating groups based on incoming data or automation triggers.
Organizing tasks or items into logical segments for better visibility.

For example, you might create a group named "Sprint 5" in a development board to separate tasks related to that sprint.

Properties

Name	Meaning
Workspace Name or ID	Select the workspace where the board resides. You can choose from a list or specify an ID using an expression.
Board Name or ID	Select the specific Monday.com board where the group will be created. Choose from a 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 a 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 result of the GraphQL mutation to create the group. It includes:

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

Example output structure:

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

No binary data is produced by this operation.

Dependencies

Requires an API key credential for Monday.com (referred generically as an API authentication token).
The node makes HTTP POST requests to the Monday.com GraphQL API endpoint at https://api.monday.com/v2.
Proper permissions on the Monday.com account to create groups on boards are necessary.
The workspace and board must exist and be accessible with the provided credentials.

Troubleshooting

API Key Not Found: If the API key credential is missing or invalid, the node will throw an error indicating the API key was not found. Ensure the credential is configured correctly.
Board ID Required: The operation requires a valid board ID. If missing or incorrect, an error will occur.
Group ID Required: For positioning relative to another group, a valid existing group ID must be provided.
Permission Errors: Insufficient permissions on the Monday.com account may cause failures when creating groups.
Invalid Color Value: Providing a color value outside the allowed options may cause the mutation to fail.
Network Issues: Connectivity problems to the Monday.com API endpoint will prevent execution.

To resolve errors:

Verify all required fields are filled correctly.
Confirm API key validity and permissions.
Check network connectivity.
Use expressions carefully to ensure correct IDs are passed.