Feishu Node icon

Feishu Node

Feishu Node

Overview

This n8n custom node enables users to copy a "多维表格" (Bitable, or multi-dimensional spreadsheet) within Feishu (Lark), a popular collaboration and productivity platform. The node is designed for scenarios where you need to duplicate an existing Bitable app—optionally into a specific folder, with a new name, and with control over whether the content is copied or not. This is useful for automating template creation, backup processes, or setting up new workspaces based on existing structures.

Practical examples:

  • Automatically create a new project workspace by copying a template Bitable.
  • Duplicate a Bitable structure without its data for onboarding new teams.
  • Backup important Bitables to another folder or root directory.

Properties

Name Type Meaning
多维表格 Token String The unique identifier of the Bitable App to be copied.
文件夹 Token String The target folder's token. If left empty, the new Bitable will be created in the root.
多维表格名称 String The name for the new Bitable App (up to 255 characters).
是否复制内容 Boolean Whether to copy the contents of the original Bitable. If false, only the structure is copied.
时区 String Time zone for the document. See Feishu documentation for valid values.

Output

The node outputs a JSON object for each processed item. The structure typically includes the result of the copy operation as returned by the Feishu API. In case of errors (and if "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:

{
  "data": {
    // ...fields returned by Feishu API about the new Bitable
  }
}

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

{
  "error": "Error message from Feishu API"
}

Dependencies

  • External Service: Requires access to the Feishu (Lark) API.
  • Credentials: Needs a configured feishuCredentialsApi credential in n8n.
  • Environment: No special environment variables are required beyond standard n8n setup.

Troubleshooting

  • Missing Method Error:
    If you see an error like 未实现方法: bitable.bitable:copy, it means the requested resource-operation combination is not implemented in the node. Double-check that you selected the correct resource and operation.
  • API Authentication Errors:
    Errors related to authentication usually indicate missing or invalid Feishu credentials. Ensure your feishuCredentialsApi is correctly set up in n8n.
  • Permission Denied:
    If the user associated with the credentials does not have permission to access or copy the specified Bitable or folder, the operation will fail.
  • Invalid Parameters:
    Providing an incorrect or empty Bitable Token, or an invalid Folder Token, will cause the API call to fail. Double-check these values.

Links and References

Discussion