Feishu Node

Actions61

Overview

This node enables uploading files or images to Feishu's "云空间" (Cloud Space) using the "上传素材" (Upload Material) operation. It is designed for scenarios where you need to programmatically upload various types of documents, images, or files to specific locations within Feishu's cloud storage, such as documents, spreadsheets, or other supported resource types.

Common use cases:

Automating the upload of reports, images, or attachments generated in workflows.
Integrating external systems with Feishu by pushing files directly into designated folders or document spaces.
Batch uploading assets to Feishu for team collaboration or archival purposes.

Practical example:
A workflow that receives a PDF report from another system and uploads it to a specific Feishu document folder for team access.

Properties

Name	Type	Meaning
上传点的类型	options	The type of upload destination (e.g., old/new doc image/file, spreadsheet, etc.).
上传点的 Token	string	The token identifying the specific upload location within Feishu Cloud Space.
二进制文件字段	string	The name of the binary field containing the file to be uploaded (default: "file").
文件名称	string	The name to assign to the uploaded file.

Output

The node outputs a JSON object for each processed item. The structure of the output depends on the response from the Feishu API after uploading the material. Typically, this includes metadata about the uploaded file, such as its ID, URL, or status.

If an error occurs and "Continue On Fail" is enabled, the output will include an error field with the error message (and possibly additional error details if available).

Example success output:

{
  "file_token": "xxxxxx",
  "name": "report.pdf",
  "url": "https://feishu.cn/space/xxxxxx",
  ...
}

Example error output (when Continue On Fail is enabled):

{
  "error": "Invalid parent_node token"
}

Dependencies

Feishu API: Requires valid Feishu credentials (feishuCredentialsApi) configured in n8n.
n8n Configuration: The node must be set up with appropriate credentials and permissions to access the target Feishu Cloud Space.

Troubleshooting

Common issues:

Invalid Token: If the "上传点的 Token" is incorrect or expired, the upload will fail with an error indicating invalid or unauthorized access.
Missing Binary Data: If the specified binary field does not contain data, the node may throw an error about missing file content.
Unsupported File Type: Uploading unsupported file types may result in API errors.

Error messages:

"未实现方法: space.space:upload": Indicates the selected resource/operation combination is not implemented.
"Invalid parent_node token": The provided upload token is invalid; verify the token value.
"NodeApiError": General API error; check the error details for more information.

How to resolve:

Double-check all input properties, especially tokens and file fields.
Ensure your Feishu credentials are valid and have necessary permissions.
Review the error message for hints on what went wrong.