Worktables icon

Worktables

Interact with Monday.com boards and items

Actions29

Overview

This node enables interaction with Monday.com via its GraphQL API, allowing users to perform a wide range of operations on various Monday.com resources such as boards, items, groups, updates, teams, users, and custom queries. Specifically, the Query - Run API operation lets users run arbitrary GraphQL queries against the Monday.com API.

Common scenarios for this node include:

  • Automating project management workflows by creating, updating, or duplicating boards and items.
  • Managing team memberships and subscribers programmatically.
  • Retrieving detailed information about boards, groups, items, updates, and users.
  • Running custom GraphQL queries to access data or perform actions not covered by predefined operations.

Practical example:

  • A user wants to fetch all boards in a specific workspace with custom filtering and sorting; they can use the "List Boards" operation.
  • For advanced use cases, the user can input any valid GraphQL query string in the "Run API" operation under the "Query" resource to execute complex or custom requests directly.

Properties

Name Meaning
Query Enter the GraphQL query string to run against the Monday.com API.

The property is a single string input where users provide their custom GraphQL query.

Output

The output is a JSON object representing the parsed response from the Monday.com GraphQL API corresponding to the executed query.

  • The json field contains the full JSON response returned by the API.
  • The structure of the output depends entirely on the query provided by the user.
  • No binary data output is produced by this operation.

Example output snippet (simplified):

{
  "data": {
    "boards": [
      {
        "id": "123456",
        "name": "Project Board"
      }
    ]
  }
}

Dependencies

  • Requires an API key credential for Monday.com with appropriate permissions to access the GraphQL API.
  • The node makes HTTP POST requests to https://api.monday.com/v2 with the query in the request body.
  • The API key must be configured in n8n credentials and linked to this node.

Troubleshooting

  • API Key Not Found: If the API key credential is missing or invalid, the node will throw an error indicating the API key was not found. Ensure the credential is properly set up and linked.
  • Invalid Query: Providing an invalid or malformed GraphQL query will result in an error from the Monday.com API. Validate your query syntax before running.
  • Permission Errors: Insufficient permissions associated with the API key may cause authorization errors. Verify that the API key has the necessary scopes.
  • Empty Query: Submitting an empty query string will cause the node to throw an "Invalid item data" error. Always provide a valid GraphQL query.
  • Network Issues: Connectivity problems to the Monday.com API endpoint will cause request failures. Check network connectivity and proxy settings if applicable.

Links and References

This summary focuses exclusively on the "Query" resource with the "Run API" operation as requested, based on static analysis of the provided source code and properties.

Discussion