Worktables icon

Worktables

Interact with Monday.com boards and items

Actions126

Overview

This node allows users to run custom GraphQL queries against the Monday.com API, supporting various operations related to Monday.com resources such as boards, items, updates, teams, users, notifications, and files. It is particularly useful for advanced users who want to perform specific or complex queries not covered by standard operations, including pagination support to fetch all pages of data automatically. For example, users can list boards, create or update items, manage teams, send notifications, or run any custom query with pagination options.

Use Case Examples

  1. Run a custom GraphQL query to list all boards with specific fields.
  2. Create a new item on a board with specified column values.
  3. Fetch all updates for a specific item with pagination.
  4. Send a notification to a user about a project update.

Properties

Name Meaning
Query The GraphQL query string to run against the Monday.com API.
API Version The version of the Monday.com API to use for the request.
Include Pagination Whether to automatically fetch all pages of data for queries that support pagination.
Pagination Type The type of pagination to use when fetching multiple pages of data (page or cursor).

Output

JSON

  • data - The data returned from the Monday.com API query, typically an object or array depending on the query.
  • totalCount - The total number of items returned when pagination is used.

Dependencies

  • Monday.com API key credential required for authentication.

Troubleshooting

  • Ensure the API key credential is correctly configured and has the necessary permissions.
  • Verify the GraphQL query syntax is correct and valid for the Monday.com API version used.
  • When using pagination, ensure the query includes a limit parameter to avoid incomplete data fetching.
  • Handle API errors gracefully; the node throws errors with messages from the Monday.com API if the query fails.

Links

Discussion