Worktables icon

Worktables

Interact with Monday.com boards and items

Overview

This node enables uploading a file to a specific file column of an item on a Monday.com board. It is useful when you want to programmatically attach files (such as documents, images, or other media) directly to an item’s file column within a Monday.com board.

Common scenarios include:

  • Automating the process of adding attachments to project tasks or items.
  • Integrating external file sources or systems to upload files into Monday.com items.
  • Enhancing workflows where files need to be stored and tracked alongside item data.

For example, you might use this node to upload a PDF report generated by another system directly into a task’s file column on Monday.com, ensuring all relevant documentation is centralized.

Properties

Name Meaning
Workspace Name or ID Select the workspace containing the board. You can choose from a list or specify an ID via expression.
Board Name or ID Select the Monday.com board where the item exists. Choose from a list or specify an ID via expression.
Is Subitem Boolean flag indicating whether to show parent item options (not used in this operation).
Item Name or ID Select the item on the board to which the file will be uploaded. Choose from a list or specify an ID via expression.
File Column Name or ID Select the file column on the item where the file should be uploaded. Only columns of type "file" are available.
Binary Property The name of the binary property in the input data that contains the file to upload. Default is "data". Use expression like {{$binary.data}}.

Output

The output JSON contains the response from the Monday.com API after attempting to upload the file to the specified item column. Typically, it includes:

  • id: The identifier of the newly added file entry.
  • url: The URL to access the uploaded file.

The node does not output binary data itself; it uploads binary data received as input to Monday.com and returns metadata about the uploaded file.

Dependencies

  • Requires an API key credential for Monday.com with appropriate permissions to modify boards and items.
  • Uses Monday.com’s GraphQL API endpoint: https://api.monday.com/v2.
  • Input binary data must be provided in the workflow for the file upload to succeed.

Troubleshooting

  • Error: "API Key not found"
    Ensure that the Monday.com API key credential is properly configured and connected in n8n.

  • Error: "Binary property 'X' is undefined."
    Verify that the binary property name specified matches the actual binary data property in the input. The default is "data" but it must correspond to the incoming binary data.

  • No valid file data found in input.
    Confirm that the previous node provides binary data and that the binary property name is correctly set.

  • Invalid Board, Item, or Column IDs
    Make sure the selected workspace, board, item, and file column exist and the IDs are correct. Use the dropdowns or expressions carefully.

  • File upload fails silently or returns unexpected results
    Check the file size and type compatibility with Monday.com file column restrictions.

Links and References

Discussion