Feishu Node

Actions61

Overview

This node allows you to add a new record to a Feishu (Lark) Bitable table. It is designed for integration with the Feishu platform, enabling automated workflows that create records in multi-dimensional tables. Common use cases include syncing data from other systems into Feishu Bitable, automating form submissions, or logging events and transactions directly into a Feishu table.

Practical examples:

Automatically adding survey responses collected via n8n to a Feishu Bitable.
Logging support tickets or customer feedback into a Feishu table for further processing.
Syncing CRM or ERP data into Feishu for reporting or collaboration.

Properties

Name	Type	Meaning
多维表格 Token	String	The unique identifier (token) of the Feishu Bitable App. Required to authenticate and specify which app's table to operate on.
多维表格 ID	String	The unique identifier of the specific Bitable table where the record will be added.
用户 ID 类型	Options	Specifies the type of user ID used in the operation. Options: Open ID, Union ID, User ID.
操作的唯一标识	String	A unique identifier for the operation. Used for idempotency; if empty, a new request is made. If provided, ensures repeated requests are safe.
是否忽略一致性读写检查	Boolean	Whether to ignore consistency checks during read/write operations. Default is true.
请求体JSON	JSON	The request body containing the fields and values for the new record. Should follow the structure defined in the Feishu API documentation.

Output

The node outputs an array of objects under the json field. Each object represents the result of the record creation operation for each input item. The structure typically includes:

{
  "data": {
    // Details about the created record as returned by the Feishu API
  }
}

If an error occurs and "Continue On Fail" is enabled, the output may look like:

{
  "error": "Error message here"
}

If the error is of type NodeApiError, additional details from the API response may be included.

Dependencies

Feishu API: Requires access to the Feishu Bitable API.
API Credentials: You must configure Feishu credentials (feishuCredentialsApi) in n8n.
Environment: No special environment variables are required beyond standard n8n credential setup.

Troubleshooting

Common Issues:

Invalid Token or Table ID: Ensure that both the App Token and Table ID are correct and have the necessary permissions.
Malformed Request Body: The 请求体JSON property must match the expected format. Refer to the Feishu API documentation.
Idempotency Errors: If using the "操作的唯一标识", ensure it is unique per operation unless intentionally retrying the same operation.

Error Messages:

未实现方法: bitable.bitable:table:record:add: Indicates the selected resource/operation combination is not implemented.
NodeApiError: Returned when the Feishu API responds with an error. Check the error message and any additional details for troubleshooting.
General errors: If "Continue On Fail" is enabled, errors are reported in the output; otherwise, execution stops.