Monday.com icon

Monday.com

Interact with Monday.com API
Join our community

Actions26

Overview

This node operation creates a new group within a specified board on Monday.com. Groups in Monday.com are used to organize items (tasks, projects, etc.) into logical sections within a board, helping users manage and categorize their work more effectively.

Common scenarios where this node is beneficial include:

  • Automating project setup by programmatically creating groups for different phases or categories.
  • Organizing tasks dynamically based on external triggers or workflows.
  • Structuring boards with predefined groups without manual intervention.

For example, you might use this node to create a "Backlog" group at the start of a sprint or a "Completed" group when archiving finished tasks.

Properties

Name Meaning
Board The target board where the new group will be created. Options are loaded dynamically from available boards.
Group Name The name of the new group to create within the selected board.

Output

The output JSON contains the response from the Monday.com API after creating the group. This typically includes details about the newly created group such as its ID, title, and other metadata returned by the API.

Example output structure (simplified):

{
  "id": "group_id",
  "title": "Group Name",
  "color": "group_color",
  "position": 1,
  ...
}

No binary data output is produced by this operation.

Dependencies

  • Requires an API key credential for Monday.com with permissions to create groups on boards.
  • The node uses the Monday.com API client internally to perform the creation.
  • The "Board" property options are dynamically loaded via an internal method that fetches available boards.

Troubleshooting

  • Common issues:

    • Invalid or missing API token: Ensure the API key credential is correctly configured and has sufficient permissions.
    • Specifying a non-existent board: Verify the board ID selected exists and is accessible by the API token.
    • Group name conflicts or invalid names: Use unique and valid group names according to Monday.com's naming rules.

  • Error messages:

    • Errors from the Monday.com API will be surfaced, e.g., permission denied or invalid input errors.
    • If the node is set to continue on fail, errors will appear in the output JSON under an error field for the respective item.

Links and References

Discussion