Worktables icon

Worktables

Interact with Monday.com boards and items

Actions26

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, optionally setting board kind, description, template, and subscribers (users and teams). This is useful for automating project setup, organizing workspaces, or dynamically creating boards based on workflow triggers.

Practical examples:

  • Automatically create a new project board in Monday.com when a new client signs up.
  • Set up a private or public board with predefined subscribers and templates for recurring workflows.
  • Organize boards into specific folders within a workspace programmatically.

Properties

Name Meaning
Board Name The name of the new board to be created.
Workspace Name or ID The workspace where the board will be created. Must be selected from available workspaces or specified by ID using an expression.
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. Must be selected from available folders or specified by ID using an expression.
User Subscribers A collection of users to subscribe to the board. Each user can be marked as an owner or subscriber. Users must be selected from available users or specified by ID using expressions.
Team Subscribers A collection of teams to subscribe to the board. Each team can be marked as an owner or subscriber. Teams must be selected from available teams or specified by ID 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. The structure is:

{
  "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.
  • The API key must have permissions to create boards and manage subscribers within the target workspace.

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 parameters like workspace ID, folder ID, or board name are missing. Verify all mandatory fields are provided.
  • Invalid Subscriber IDs: When adding user or team subscribers, invalid or non-existent IDs may cause errors. Confirm that user and team IDs exist and are accessible with the API key.
  • Folder ID "-1" Handling: The folder ID -1 represents "None" (no folder). Passing this value excludes the folder from the creation mutation.
  • GraphQL Syntax Errors: Since the node constructs GraphQL queries dynamically, improper escaping or formatting of strings (e.g., board name or description) might cause syntax errors. Use valid characters and escape quotes if necessary.

Links and References

If you need details about other operations or resources, feel free to ask!

Discussion