Feishu Node icon

Feishu Node

Feishu Node

Overview

This custom n8n node allows users to create a new document in Feishu (飞书) 云文档 (Cloud Document). It is designed for scenarios where automated workflows need to generate documents, such as creating meeting notes, reports, or collaborative files directly from other workflow data. For example, you could use this node to automatically generate a project summary document in a specific folder whenever a new project is created in your system.

Properties

Name Type Meaning
文档标题 String The title of the document. Only plain text is supported. Length: 1–800 characters.
文件夹 Token String The token identifying the folder where the document will be created. Leave empty for root.

Output

The node outputs a JSON object containing the result of the document creation operation. While the exact structure depends on the Feishu API response, typical fields may include:

  • The ID or token of the newly created document
  • Metadata such as the document title, creation time, and folder location
  • Any error messages if the operation fails

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

Dependencies

  • Feishu Account: Requires valid Feishu credentials configured in n8n under feishuCredentialsApi.
  • API Access: The connected Feishu account must have permission to create documents in the specified workspace/folder.
  • n8n Configuration: No additional environment variables are required beyond standard credential setup.

Troubleshooting

Common Issues:

  • Invalid Credentials: If the Feishu credentials are missing or incorrect, the node will fail to authenticate.
  • Insufficient Permissions: If the user does not have permission to create documents in the target folder, the operation will fail.
  • Invalid Folder Token: Providing an incorrect or expired folder token will result in an error.
  • Title Validation: If the document title is empty or exceeds 800 characters, the API may reject the request.

Error Messages:

  • "未实现方法: doc.doc:create": Indicates that the requested resource-operation combination is not implemented in the node.
  • Errors with NodeApiError: These typically include more details from the Feishu API, such as invalid parameters or authentication failures.

Resolution Steps:

  • Double-check Feishu credentials in n8n.
  • Ensure the folder token is correct and accessible by the authenticated user.
  • Validate that the document title meets length and format requirements.

Links and References

Discussion