Feishu Node icon

Feishu Node

Feishu Node

Actions106

Overview

This node integrates with the Feishu platform to save or create fields in a multi-dimensional table (多维表格). It allows users to define new fields for a specified table either by specifying individual field properties or by providing a JSON body describing multiple fields. This is useful when automating the management of table schemas within Feishu, such as adding custom columns programmatically based on dynamic data or workflows.

Practical examples include:

  • Automatically adding new columns to a project tracking table when new data categories are introduced.
  • Updating table schemas in bulk by sending JSON definitions.
  • Managing user-defined fields in a collaborative environment without manual UI interaction.

Properties

Name Meaning
多维表格 Token The unique identifier token for the Feishu App, used for authenticating API requests.
多维表格 ID The unique identifier of the multi-dimensional table where fields will be saved or created.
字段定义方式 Method to define fields: either "Field" (individual field definitions) or "JSON" (raw JSON array describing fields).
字段列表 When using "Field" definition mode, this is a collection of fields to create. Each field includes:
- 字段名称 (field name)
- 字段类型 (field type), options include text, number, single/multi-select, date, checkbox, person, phone, hyperlink, attachment, relations, formula, location, group, timestamps, creator/modifier, auto-number.
- 字段扩展属性 (field extension attributes) as JSON, merged automatically per Feishu API specs.
请求体JSON When using "JSON" definition mode, this is the raw JSON array representing the fields to create, matching Feishu's API request body format.

Output

The node outputs an array of JSON objects representing the result of the field creation operation(s). Each output item corresponds to one input item processed and contains the response from Feishu's API about the created fields.

If the operation fails for any item and "Continue On Fail" is enabled, the output for that item will contain an error object describing the failure.

No binary data output is produced by this node.

Dependencies

  • Requires a valid Feishu App token credential to authenticate API calls.
  • Needs network access to Feishu's open API endpoints.
  • The node depends on n8n's internal helper methods for constructing execution metadata and error handling.

Troubleshooting

  • Common issues:

    • Invalid or expired Feishu App token causing authentication failures.
    • Incorrect table ID leading to "table not found" errors.
    • Malformed JSON in the "请求体JSON" property causing API request rejections.
    • Using unsupported or incorrect field types or missing required field properties.

  • Error messages:

    • "未实现方法: 多维表格.保存字段" indicates the requested resource-operation combination is not implemented; verify correct Resource and Operation selection.
    • API errors returned from Feishu will be surfaced, often including error codes and messages; check token validity and API documentation for resolution.
    • JSON parsing errors if the JSON input is invalid; ensure proper JSON formatting.

  • Resolutions:

    • Verify and refresh the Feishu App token credential.
    • Double-check the table ID and field definitions.
    • Validate JSON syntax before inputting into the node.
    • Enable "Continue On Fail" to allow partial processing and easier debugging.

Links and References

Discussion