Worktables icon

Worktables

Interact with Monday.com boards and items

Actions26

Overview

The node "Worktables" integrates with Monday.com to interact with various resources such as boards, items, subitems, updates, teams, users, and custom queries. Specifically, for the Board resource and the Get a Board operation, it retrieves detailed information about a specific Monday.com board by its ID or name within a selected workspace.

This node is beneficial when you want to programmatically fetch comprehensive details of a Monday.com board, including its columns, groups, subscribers, URL, description, and metadata. For example, you might use this node to synchronize board data with another system, generate reports based on board structure, or trigger workflows based on board properties.

Properties

Name Meaning
Workspace Name or ID Select the workspace containing the board. You can choose from a list or specify an ID via expression. This is required.
Board Name or ID Select the specific Monday.com board to retrieve. Choose from the list or specify an ID using an expression. This is required.

These properties are used to identify the exact board to fetch details from within a given workspace.

Output

The output JSON contains the full details of the requested board, structured as follows:

  • id: The unique identifier of the board.
  • name: The name of the board.
  • description: Text description of the board.
  • board_kind: The type/kind of the board (e.g., public, private).
  • columns: An array of column objects, each with:
    • id: Column ID.
    • title: Column title.
    • type: Column type.
  • groups: An array of group objects within the board, each with:
    • id: Group ID.
    • title: Group title.
  • items_count: Number of items in the board.
  • subscribers: List of subscribers to the board, each with:
    • id: Subscriber ID.
    • name: Subscriber name.
  • url: The web URL of the board.
  • updated_at: Timestamp of last update.
  • workspace: Object containing workspace id and name.

The node returns this data wrapped inside the standard n8n output format under the json key.

Dependencies

  • Requires an API key credential for Monday.com API access.
  • The node makes HTTP POST requests to the Monday.com GraphQL API endpoint: https://api.monday.com/v2.
  • Proper configuration of the Monday.com API key in n8n credentials is mandatory.
  • The workspace and board IDs must be valid and accessible by the provided API key.

Troubleshooting

  • API Key not found: If the API key credential is missing or invalid, the node will throw an error. Ensure the API key is correctly set up in n8n credentials.
  • Board ID is required: When the board ID property is empty or invalid, the node cannot perform the query. Make sure to select or provide a valid board ID.
  • Workspace ID is required: Similarly, the workspace must be specified; otherwise, the node will fail.
  • Permission errors: If the API key does not have sufficient permissions to access the board or workspace, the request will fail. Verify API key scopes and user permissions in Monday.com.
  • Invalid GraphQL query: Although unlikely in this static implementation, malformed queries or unexpected API changes could cause errors. Check the Monday.com API documentation if issues arise.

Links and References

Discussion