Worktables

Overview

This node integrates with Monday.com (referred to as "Worktables" in the code) via its GraphQL API, enabling automation workflows to interact with Monday.com boards, items, groups, teams, users, updates, and queries.

Specifically for the Item resource and the Get an Item operation, the node retrieves detailed information about a specific item on a Monday.com board by its ID. This includes the item's metadata such as its name, creation and update timestamps, and all column values associated with the item.

Common scenarios where this is useful:

• Fetching detailed data of a task or project item to use in subsequent workflow steps.
• Synchronizing Monday.com item data with other systems like CRMs or databases.
• Triggering conditional logic based on the properties or status of a specific item.
• Reporting or auditing item details programmatically.

Practical example:

You have an automation that triggers when a new email arrives. You want to fetch the corresponding Monday.com item by its ID (perhaps extracted from the email content) to check its status or assigned user before deciding how to respond or route the email.

Properties

Output

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

{
  "items": [
    {
      "id": "string",               // The item's unique ID
      "name": "string",             // The item's name/title
      "created_at": "string",       // Timestamp when the item was created
      "updated_at": "string",       // Timestamp when the item was last updated
      "column_values": [            // Array of column value objects for the item
        {
          "id": "string",           // Column ID
          "text": "string",         // Text representation of the column's value
          "value": "string"         // Raw value of the column (usually JSON string)
        }
      ]
    }
  ]
}

• The column_values array provides the values of all columns configured on the board for this item.
• The node returns the parsed JSON response from Monday.com's API inside the json field of the output.

The node does not output binary data for this operation.

Dependencies

• Requires an API key credential for Monday.com (referred to generically as "an API key credential").
• The node makes HTTP POST requests to the Monday.com GraphQL API endpoint at https://api.monday.com/v2.
• Proper permissions/scopes must be granted to the API key to read item data.

Troubleshooting

Common issues

• Missing or invalid API key: The node throws an error if the API key is not found or invalid. Ensure you have configured the API key credential correctly.
• Invalid or missing Item ID: The operation requires a valid item ID. If omitted or incorrect, the API will return an error or empty results.
• Permission errors: The API key must have access rights to the board and item queried; otherwise, the request will fail.
• API rate limits: Excessive requests may hit Monday.com's rate limits, causing temporary failures.

Error messages and resolutions

• "API Key not found": Check that the API key credential is set up and linked properly in n8n.
• "Unsupported operation: getItem" or "Unsupported resource: item": Verify that the Resource and Operation parameters are correctly set.
• Errors related to item ID: Confirm the item ID exists and is accessible with the provided API key.
• Network or HTTP errors: Ensure network connectivity and that Monday.com's API endpoint is reachable.

Links and References

• Monday.com API Documentation (GraphQL): https://api.developer.monday.com/docs/apis-overview-introduction
• Monday.com Items API: https://api.developer.monday.com/docs/items
• n8n Expressions Documentation: https://docs.n8n.io/code-examples/expressions/
• Monday.com API Authentication: https://api.developer.monday.com/docs/authentication

If you need summaries for other resources or operations, feel free to ask!