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:
- Log into your Monday.com account.
- Open the Developers section from your user menu.
- Go to My Access Tokens.
- 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.