Feishu Node icon

Feishu Node

Feishu Node

Actions61

Overview

This custom n8n node allows users to add a new data table to Feishu's "多维表格" (Bitable) application. It is designed for scenarios where you need to programmatically create tables within a Feishu Bitable app, such as automating workspace setup, onboarding processes, or integrating Feishu with other systems that require dynamic table creation.

Practical examples:

  • Automate the creation of project tracking tables when a new project is initiated.
  • Integrate with external systems to generate tables based on incoming data structures.
  • Set up standardized templates for teams by creating tables via workflow automation.

Properties

Name Type Meaning
多维表格 Token String The unique identifier (token) for the Feishu Bitable App. Required for authentication.
请求体JSON JSON The request body in JSON format specifying the table structure. See Feishu API docs for details.

Output

The node outputs a json object containing the response from the Feishu API after attempting to create the table. The exact structure depends on the Feishu API's response, but typically includes information about the newly created table, such as its ID and configuration.

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:

{
  "table_id": "tblxxxxxxxxxxxx",
  "name": "New Table",
  // ...other fields returned by Feishu API
}

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

{
  "error": "Invalid token or malformed request"
}

Dependencies

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

Troubleshooting

  • Common Issues:

    • Invalid Token: If the "多维表格 Token" is incorrect or expired, the API will reject the request.
    • Malformed Request Body: If "请求体JSON" does not match the expected schema, the API will return an error.
    • Missing Credentials: If Feishu credentials are not set up in n8n, the node will fail to authenticate.

  • Error Messages:

    • "未实现方法: bitable.bitable:table:add": Indicates the selected resource/operation combination is not implemented in the node.
    • "Invalid token or malformed request": Check your token and ensure the request body matches the API documentation.
    • NodeApiError: Usually indicates an issue with the API call; check the error details for more information.

How to resolve:

  • Double-check your Feishu App token and permissions.
  • Validate your JSON request body against the Feishu API documentation.
  • Ensure n8n has the correct Feishu credentials configured.

Links and References

Discussion