Monday.com

Provides integration with Monday.com using their GraphQL API.

Revision History

1.0.0.0 Initial Release

Properties

Connection

Type: Connection Input
The connection profile for the Monday.com API, including your API access token and optional API version.

AccessToken
Type: Password
Your Monday.com API access token for authentication.

Version
Type: String
(Optional) The API version to use for requests (e.g., "2024-01"). If left empty, the current API version is used.

Operation

Type: String Input
Choose the type of operation to perform:

  • Query — Run a GraphQL query
  • Mutation — Run a GraphQL mutation

Object

Type: String Input
The root GraphQL object to query or mutate (e.g., items, boards).

SelectionSet

Type: Multiline Text Input
The GraphQL selection set describing which fields to return for the specified object.

ValidateSelectionSet

Type: Boolean Input
Whether to validate the selection set against the current schema. Default is true.

Request

Type: Multiline Text Input
For mutations, the JSON request body to send as input data.

Response

Type: Multiline Text Output
The raw JSON response from the Monday.com API.

Custom Inputs

Supports Custom Input Properties which can be added dynamically based on selected samples. These custom properties are passed as variables in GraphQL requests.

Remarks

Authentication

To obtain an API token:

  1. Log into your Monday.com account.
  2. Open the Developers section from your user menu.
  3. Go to My Access Tokens.
  4. Show and copy your access token.

Paste this token into the AccessToken field in the Connection.

API Versioning

If you specify a version in the Connection’s Version property, that version will be used for requests. If left empty, the current default API version will be used. Monday.com generally supports each API version for at least six months, allowing stable integrations.

Samples

The node includes built-in sample queries and mutations based on the latest schema to assist in building workflows.

File Uploads

The node supports uploading files using GraphQL mutations that accept a File input.

When such a mutation is selected, the node will automatically generate a file input sample with the correct structure. You only need to provide the file name and the file content. The file content can be a base64-encoded string, a plain string, or a byte array.

The node will automatically format and transmit the file according to Monday.com’s expected upload format. No additional configuration is required.

Troubleshooting Empty Values in Responses

If your node returns empty values or missing fields when you expect data, it may be due to sensitive fields included in your selection set.

Some fields in Monday.com's API are protected or restricted and can cause the API to omit those fields or objects silently, without throwing errors.

How to Diagnose

To identify which field is causing the issue:

  1. Use a tool like Postman or similar API client.
  2. Start with a minimal selection set in your GraphQL query.
  3. Gradually add fields back one by one.
  4. Observe when the response changes from valid data to empty or missing values.

Summary

  • Sensitive fields can cause empty or missing data without errors.
  • Narrow down your query by testing fields individually.
  • Adjust your selection set to exclude problematic sensitive fields if needed.

Links