Feishu Node

Actions61

Overview

This n8n custom node is designed to interact with Feishu's "多维表格" (Bitable) service, specifically for the operation of updating a field within a Bitable table. The node allows users to programmatically modify the properties of a specific field in a given Bitable table by providing the necessary identifiers and update data.

Common scenarios:

Automating schema changes in Feishu Bitable tables as part of a workflow.
Updating field names, types, or other attributes based on external triggers or business logic.
Integrating Feishu Bitable management into broader automation pipelines.

Practical example:
Suppose you have a workflow that needs to rename a column or change its type in a Feishu Bitable table after certain conditions are met. This node can be used to perform that update automatically.

Properties

Name	Type	Meaning
多维表格 Token	String	The unique identifier (token) for the Feishu Bitable App. Required for authentication.
多维表格 ID	String	The unique identifier for the target Bitable table where the field exists.
字段 ID	String	The unique identifier of the field (column) to be updated within the table.
请求体JSON	JSON	The request body containing the new field properties. See API docs for structure. Example: `{"field_name":"测试","type":1}`

Output

The node outputs an array of items, each with a json property containing the response from the Feishu API. 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 output (success):

[
  {
    "json": {
      // ...fields returned by Feishu API after updating the field
    }
  }
]

Example output (error, with Continue On Fail):

[
  {
    "json": {
      "error": "Error message here"
    }
  }
]

Dependencies

Feishu API: Requires access to the Feishu Bitable API.
Credentials: Needs a configured feishuCredentialsApi credential in n8n, which should contain the necessary authentication information (such as app token).
Environment: No special environment variables are required beyond standard n8n configuration.

Troubleshooting

Common issues:

Invalid credentials: If the provided Feishu Token is incorrect or expired, the node will fail with an authentication error.
Incorrect IDs: Supplying an invalid Table ID or Field ID will result in errors indicating that the resource was not found.
Malformed JSON: If the "请求体JSON" property is not valid JSON or does not match the expected structure, the API may return a validation error.

Error messages:

"未实现方法: bitable.bitable:table:field:update": Indicates that the requested resource-operation combination is not implemented in the node.
"NodeApiError": A generic error from the underlying API call; check the error field for more details.
"Error message here": Any other error message will be passed through from the Feishu API or internal processing.

How to resolve:

Double-check all IDs and tokens.
Ensure the request body matches the Feishu API documentation.
Review the error message for hints about what went wrong.