Worktables icon

Worktables

Interact with Monday.com boards and items

Actions29

Overview

The node enables interaction with Monday.com boards and related entities via the Monday.com API. Specifically, for the Board resource and the Create a Board operation, it allows users to create new boards within a specified workspace and folder. Users can define board properties such as name, kind (public, private, shareable), description, template ID, and assign subscribers (users and teams) with owner or subscriber roles.

This node is beneficial in scenarios where automated project management setup is needed, such as:

  • Automatically creating project boards when onboarding new clients.
  • Setting up standardized boards from templates for recurring workflows.
  • Assigning team members and owners programmatically during board creation.

Example: Creating a new public board named "Marketing Campaign" in a specific workspace and folder, with designated user and team subscribers assigned as owners or subscribers.

Properties

Name Meaning
Board Name The name of the new board to be created.
Workspace Name or ID The workspace under which the board will be created. Select from a list or specify an ID using expressions.
Board Kind The type of board to create. Options are: Public, Private, or Shareable.
Description Optional description text for the board.
Template ID Optional template ID to base the new board on.
Folder Name or ID The folder within the workspace where the board will be placed. Select from a list or specify an ID using expressions.
User Subscribers A collection of users to subscribe to the board. Each user can be marked as an owner (Is Owner true) or subscriber (Is Owner false). Choose users from a list or specify IDs using expressions.
Team Subscribers A collection of teams to subscribe to the board. Each team can be marked as an owner (Is Owner true) or subscriber (Is Owner false). Choose teams from a list or specify IDs using expressions.

Output

The output JSON contains the response from the Monday.com API after creating the board. Typically, this includes at least the newly created board's ID:

{
  "data": {
    "create_board": {
      "id": "123456789"
    }
  }
}

This ID can be used in subsequent operations to reference the created board.

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: https://api.monday.com/v2.
  • Proper permissions on the API key are necessary to create boards and manage subscribers.

Troubleshooting

  • API Key Not Found: If the API key credential is missing or invalid, the node throws an error indicating the API key was not found. Ensure the credential is configured correctly in n8n.
  • Missing Required Parameters: Errors occur if required fields like workspace ID, folder ID, or board name are not provided. Verify all mandatory inputs are set.
  • Invalid Template ID or Folder ID: Providing incorrect IDs may cause API errors. Use the node's dropdowns or valid expressions to ensure correct values.
  • Subscriber Assignment Issues: If user or team IDs are invalid or lack permission, adding them as subscribers or owners may fail. Confirm that the users/teams exist and the API key has rights to modify subscriptions.
  • GraphQL Syntax Errors: Since the node constructs GraphQL queries dynamically, malformed input strings (e.g., unescaped quotes in descriptions) might cause errors. Validate input formatting.

Links and References

Discussion