Feishu Node icon

Feishu Node

Feishu Node

Actions61

Overview

This n8n custom node allows users to add a new view to a "多维表格" (Bitable, Feishu's multi-dimensional spreadsheet) table. The node is designed for integration with Feishu (Lark), enabling workflow automation that programmatically creates different types of views (such as grid, kanban, gallery, gantt, or form) within a specified Bitable table.

Common scenarios:

  • Automating the setup of new projects by creating standardized views in project management tables.
  • Dynamically generating specific views for reporting or data entry based on workflow triggers.
  • Integrating with other systems to provision new Feishu Bitable views as part of onboarding or process automation.

Practical example:
When a new client is added to your CRM, this node can automatically create a set of views (e.g., Kanban for tasks, Grid for contacts) in a dedicated Bitable table for that client.

Properties

Name Type Meaning
多维表格 Token String The unique identifier (token) for the Bitable App. Required to authenticate API requests.
多维表格 ID String The unique identifier for the Bitable table where the view will be added.
视图名称 String The name of the new view (max 100 characters, cannot be empty or contain [ ]).
视图类型 Options The type of view to create. Options: 表格视图 (Grid), 看板视图 (Kanban), 画册视图 (Gallery), 甘特视图 (Gantt), 表单视图 (Form).

Output

The node outputs an array of items, each containing a json field. The structure of the output depends on the response from the Feishu API when adding a new view. Typically, it will include details about the newly created view, such as its ID, name, and type. If an error occurs and "Continue On Fail" is enabled, the output item will have a JSON object with an error field describing the issue.

Example success output:

{
  "view_id": "v123456",
  "view_name": "新建视图",
  "view_type": "grid",
  // ...other fields returned by the API
}

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

{
  "error": "Invalid token or insufficient permissions"
}

Dependencies

  • Feishu (Lark) API: Requires access to the Feishu Bitable API.
  • API Credentials: The node requires a credential named feishuCredentialsApi to authenticate requests.
  • n8n Configuration: Ensure the Feishu credentials are properly configured in n8n.

Troubleshooting

Common issues:

  • Invalid Token or Table ID: If the provided token or table ID is incorrect, the API will return an error.
  • Insufficient Permissions: The credentials used must have permission to add views to the specified Bitable table.
  • View Name Constraints: The view name must not be empty, exceed 100 characters, or contain square brackets [ ].

Error messages:

  • "未实现方法: bitable.bitable:table:view:add": Indicates the operation is not implemented in the node. Double-check the resource and operation selection.
  • "Invalid token or insufficient permissions": Check your Feishu credentials and ensure they have the necessary access.
  • "View name invalid": Ensure the view name meets the constraints described above.

Links and References

Discussion