Actions26
- Board Actions
- Item Actions
- Update Actions
- Team Actions
- Query Actions
Overview
The node "Worktables" integrates with Monday.com to interact with various resources such as boards, items, subitems, updates, teams, and users. Specifically, the Get a Board operation under the Board resource retrieves detailed information about a specific Monday.com board.
This operation is useful when you want to fetch comprehensive details of a particular board, including its columns, groups, subscribers, workspace info, and metadata like description, kind, URL, and update timestamps. It can be used in scenarios such as:
- Displaying board details in dashboards or reports.
- Syncing board structure and metadata with other tools.
- Automating workflows that depend on board configuration or membership.
Example use case: Automatically retrieve a board's structure and subscriber list before performing further automation steps like item creation or updates.
Properties
| Name | Meaning |
|---|---|
| Workspace Name or ID | Select the workspace containing the board. Can choose from a dropdown or specify an ID via expression. Required. |
| Board Name or ID | Select the specific Monday.com board to retrieve. Can choose from a dropdown or specify an ID via expression. Required. |
These properties are required to identify the exact board within a workspace for which details will be fetched.
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: Type of the board (e.g., public, private).columns: Array of column objects, each with:id: Column ID.title: Column title.type: Column type.
groups: Array of group objects, each with:id: Group ID.title: Group title.
items_count: Number of items on the board.subscribers: Array of subscriber objects, each with:id: Subscriber ID.name: Subscriber name.
url: Web URL of the board.updated_at: Timestamp of last update.workspace: Object with workspaceidandname.
This rich data allows downstream nodes or processes to understand the board’s structure, membership, and metadata comprehensively.
The node does not output binary data for this operation.
Dependencies
- Requires an API key credential for Monday.com API access.
- Makes HTTP POST requests to the Monday.com GraphQL API endpoint at
https://api.monday.com/v2. - The API key must have sufficient permissions to read board details.
- No additional environment variables or external services are required beyond the Monday.com API access.
Troubleshooting
- API Key Not Found: If the API key credential is missing or invalid, the node throws an error. Ensure the API key is correctly configured in n8n credentials.
- Board ID Required: The operation requires a valid board ID. If missing or incorrect, the node will throw an error indicating the board ID is required.
- Workspace ID Required: Similarly, the workspace ID must be provided; otherwise, the request may fail or return no results.
- Permission Errors: If the API key lacks permission to access the specified board or workspace, the API will return errors. Verify the API key’s scopes and user permissions in Monday.com.
- Invalid Query Response: If the API response cannot be parsed as JSON, it may indicate network issues or API changes. Check connectivity and API status.