Feishu Node

Actions61

Overview

This n8n custom node enables batch creation of records in a Feishu (Lark) 多维表格 (Bitable) table. It is designed for scenarios where you need to insert multiple rows into a Feishu Bitable database efficiently, such as synchronizing data from other systems, bulk importing datasets, or automating record creation based on workflow triggers.

Practical examples:

Importing a list of new users or products into a Feishu Bitable table.
Syncing CRM or ERP data into Feishu for reporting or collaboration.
Automating the addition of survey responses or form submissions to a Feishu table.

Properties

Name	Type	Meaning
多维表格 Token	String	The unique identifier (token) for the Feishu Bitable App. Required for authentication and API access.
多维表格 ID	String	The unique identifier for the specific Bitable table where records will be added.
用户 ID 类型	Options	Specifies the type of user ID used in the operation. Options include Open ID, Union ID, and User ID.
操作的唯一标识	String	A unique identifier for the operation (client_token). Used for idempotency; if empty, a new request is made; if provided, ensures repeated requests are treated as the same operation.
是否忽略一致性读写检查	Boolean	Whether to ignore consistency checks during read/write operations. Default is true.
请求体JSON	JSON	The request body containing the records to add. Must follow the structure defined by Feishu's API documentation (reference). Example: {"records": []}

Output

json:
- On success: Returns the response from the Feishu API, typically including details about the created records (such as their IDs and any additional metadata returned by the API).
- On error (if "Continue On Fail" is enabled): Returns an object with an error field describing the issue. If the error is a NodeApiError, it may include more detailed information from the API response.

Note: This node does not output binary data.

Dependencies

Feishu API: Requires valid credentials (feishuCredentialsApi) configured in n8n.
API Keys / Tokens: You must provide the "多维表格 Token" and ensure your credentials have permission to write to the specified Bitable table.
n8n Configuration: Ensure the Feishu credential type is 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.
Malformed Request Body: If the "请求体JSON" property does not match the expected format, the Feishu API will return an error.
Missing Required Fields: Omitting required properties (like Table ID or Token) will result in errors.
Idempotency Conflicts: Reusing the same "操作的唯一标识" (client_token) unintentionally can cause unexpected results due to idempotency.

Error Messages:

"未实现方法: bitable.bitable:table:record:batchAdd": Indicates that the selected resource/operation combination is not implemented in the node.
Errors with NodeApiError: These usually contain details from the Feishu API response. Check the error field in the output for specifics.
General JavaScript errors: Will appear in the error field if "Continue On Fail" is enabled.

How to resolve:

Double-check all input fields for correctness.
Refer to the Feishu API documentation for the correct request body structure.
Ensure your credentials have sufficient permissions.