Feishu Node icon

Feishu Node

Feishu Node

Actions61

Overview

This n8n custom node enables users to save (create or update) fields in a Feishu (Lark) Bitable table. It is designed for scenarios where you need to programmatically manage the schema of a Bitable table—such as adding new columns, updating field definitions, or automating table structure changes as part of a workflow.

Common use cases:

  • Automating the setup of new Bitable tables with predefined fields.
  • Updating field properties in response to business logic or external triggers.
  • Bulk creation of multiple fields based on dynamic input.

Practical example:
A company onboarding process could use this node to automatically add required fields to a new employee data table whenever a new department is created.

Properties

Name Type Meaning
多维表格 Token String The unique identifier (token) for the Bitable App. Required for authentication and API access.
多维表格 ID String The unique identifier for the specific Bitable table to modify.
字段定义方式 Options Determines how fields are defined: "Field" (form-based) or "JSON" (raw JSON).
字段列表 FixedCollection List of field definitions (used when "字段定义方式" is "Field"). Each includes name, type, and extra data.
请求体JSON JSON Raw JSON array of field definitions (used when "字段定义方式" is "JSON").

Output

The node outputs an array of JSON objects, each corresponding to the result of saving a field (or fields) for an input item. The exact structure depends on the Feishu Bitable API's response, but typically includes:

[
  {
    "field_id": "fldxxxxxx",
    "field_name": "Example Field",
    "type": 1,
    "data": { /* field-specific properties */ }
    // ...other metadata from the API
  }
]

If an error occurs and "Continue On Fail" is enabled, the output will include:

{
  "error": "Error message or details"
}

Note: This node does not output binary data.

Dependencies

  • Feishu (Lark) Bitable API: Requires valid credentials (feishuCredentialsApi) configured in n8n.
  • API Keys / Tokens: You must provide the "多维表格 Token" (App token) and "多维表格 ID" (Table ID).
  • n8n Configuration: Ensure the Feishu credentials are set up in your n8n instance.

Troubleshooting

Common Issues:

  • Invalid Credentials: If the provided token or credentials are incorrect, the node will throw an authentication error.
  • Missing Required Fields: Omitting required properties (like field name or type) will cause validation errors.
  • Incorrect JSON Format: When using "请求体JSON", ensure the JSON is properly formatted; otherwise, parsing errors will occur.
  • API Limitations: Exceeding rate limits or using unsupported field types may result in API errors.

Error Messages:

  • 未实现方法: bitable.bitable:table:field:save — Indicates the selected resource/operation combination is not implemented.
  • NodeApiError — Usually means an error was returned by the Feishu API; check the error message for details.
  • Error message or details — General error information; review the message for hints on resolution.

How to resolve:

  • Double-check all required property values.
  • Validate your JSON input if using raw mode.
  • Ensure your Feishu app has the necessary permissions.

Links and References

Discussion