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. Users can define board properties such as name, kind (public, private, shareable), description, template, and assign subscribers (users and teams) with ownership or subscriber roles.

This node is beneficial in automation workflows where new project boards need to be programmatically created based on triggers or other data inputs, such as onboarding new projects, setting up team collaboration spaces, or templating recurring board structures.

Practical Example

  • Automatically create a new project board in Monday.com when a new client is added to your CRM.
  • Create a private board for a specific team with predefined subscribers and a description.
  • Use a template ID to quickly spin up standardized boards for recurring processes.

Properties

Name Meaning
Board Name The name of the new board to create.
Workspace Name or ID The workspace under which the board will be created. Select from a list or specify an ID via expression.
Board Kind The type of board to create. Options: Public, Private, 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. Required. Choose from the list or specify an ID via expression.
User Subscribers A collection of users to subscribe to the board. Each user can be marked as an owner or subscriber. Users are selected by name or ID.
Team Subscribers A collection of teams to subscribe to the board. Each team can be marked as an owner or subscriber. Teams are selected by name or ID.

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 workflow steps 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 in the specified workspace.

Troubleshooting

  • API Key Not Found: If the API key credential is missing or invalid, the node throws an error. Ensure the API key is configured correctly in n8n credentials.
  • Missing Required Parameters: The workspace, folder, and board name are required. Omitting these will cause errors.
  • Invalid Template ID or Folder ID: Providing incorrect IDs may result in API errors. Verify IDs exist and belong to the correct workspace.
  • Permission Errors: The API key must have sufficient permissions to create boards and assign subscribers.
  • Subscriber IDs: When adding user or team subscribers, ensure the IDs are valid and that the API key has rights to manage subscriptions.

Links and References

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

Discussion