Monday.com Files

Provides integration with Monday.com focusing on GraphQL mutations that require file uploads.

Revision History

1.1.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.

Object

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

SelectionSet

Type: Multiline Text Input
The GraphQL selection set describing which fields to return.

ValidateSelectionSet

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

FileName

Type: String Input
The name of the file being uploaded (e.g., document.pdf).

File

Type: Binary Input
The file content to upload. Supported formats include base64-encoded strings, UTF-8 strings, byte arrays, or streams.

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 and support nested property paths using dot notation (e.g., "parent.child.property").

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.

File Upload Handling

This node handles uploading files in the format expected by Monday.com’s API. You just provide the file name and content, and the node takes care of sending it correctly.

You only need to provide:

  • The file name (FileName)
  • The file content (File)

The node automatically formats and transmits the file content without additional setup.

Samples

The node includes built-in sample mutations that only involve file uploads, generated from the current Monday.com GraphQL schema to help get you started quickly.

Custom Properties

You can add extra input values to your mutation using custom properties. If you need to specify values inside nested objects, just use dot-separated names (like parent.child.property), and the node will handle the rest.

Troubleshooting Empty or Missing Fields

Sensitive or restricted fields in Monday.com’s API may be omitted from responses silently.

If you encounter missing data:

  • Test your selection set with minimal fields via an API client.
  • Add fields incrementally to identify problematic ones.
  • Adjust your selection set accordingly.

Links