Feishu Node

Actions61

Overview

This node allows you to upload a file to Feishu's 云空间 (Cloud Space) by providing a URL. It is designed for scenarios where you have a file hosted online and want to import it directly into Feishu without downloading and re-uploading manually. This is useful for automating document management, archiving web resources, or integrating external content into your Feishu workspace.

Practical examples:

Automatically saving reports generated by other systems into Feishu documents.
Migrating files from another cloud service to Feishu using their public URLs.
Archiving images or spreadsheets shared via links into Feishu for team collaboration.

Properties

Name	Type	Meaning
上传点的类型	options	The type of upload destination in Feishu (e.g., document image, spreadsheet file, etc.).
上传点的 Token	string	The token identifying the specific upload location within Feishu Cloud Space.
文件链接	string	The URL of the file to be uploaded.
文件名称	string	The name to assign to the uploaded file in Feishu.

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 file. Typically, this will include information such as:

Upload status
File metadata (such as ID, name, type)
Any error messages if the upload failed

If an error occurs and "Continue On Fail" is enabled, the output will contain an error field with the error message.

Example output (success):

{
  "file_id": "xxxxxx",
  "file_name": "example.pdf",
  "status": "uploaded"
}

Example output (failure with Continue On Fail):

{
  "error": "Invalid file URL"
}

Dependencies

Feishu API: Requires valid Feishu credentials (feishuCredentialsApi) configured in n8n.
External file URL: The file must be accessible via the provided URL.
n8n configuration: No special environment variables are required beyond standard credential setup.

Troubleshooting

Common issues:

Invalid or expired Feishu credentials: Ensure that your Feishu API credentials are correct and have not expired.
Inaccessible file URL: The provided file link must be publicly accessible; otherwise, the upload will fail.
Unsupported file type or size: Feishu may restrict certain file types or sizes depending on the upload point type.

Error messages:

未实现方法: space.space:uploadByUrl: Indicates that the selected resource/operation combination is not implemented.
Invalid file URL: The file could not be fetched from the provided URL. Check the link and try again.
NodeApiError: A generic error from the Feishu API, often containing more details in the error field.

How to resolve:

Double-check all input fields, especially the file URL and upload token.
Verify your Feishu credentials in n8n.
Consult Feishu documentation for any restrictions on file uploads.