Feishu Node icon

Feishu Node

Feishu Node

Actions106

Overview

This node allows users to add new records to a multi-dimensional table (多维表格) within the Feishu platform. It is useful for automating data entry into Feishu's table apps, enabling integration with other workflows or systems that generate or manipulate tabular data. For example, you could use this node to automatically log form submissions, sync CRM data, or update inventory records in a Feishu table.

Properties

Name Meaning
多维表格 Token The unique identifier token of the Feishu App (多维表格 App). This authenticates and specifies which app the record will be added to.
多维表格 ID The unique identifier of the specific multi-dimensional data table where the record will be inserted.
用户 ID 类型 The type of user ID used for identification. Options are: Open ID, Union ID, or User ID.
操作的唯一标识 A unique client token for idempotency. If empty, a new request is made; if provided, it ensures the operation is idempotent by updating the existing request corresponding to this token.
是否忽略一致性读写检查 Boolean flag indicating whether to ignore consistency checks during read/write operations. Defaults to true.
请求体JSON The JSON body of the request specifying the fields and values for the new record. Must follow the structure defined in Feishu’s API documentation for creating table records. Example: {"fields":{}}

Output

The node outputs an array of JSON objects representing the results of the add record operations. Each output item corresponds to an input item processed and contains the response data from the Feishu API about the newly created record. The exact structure depends on the API response but typically includes identifiers and metadata of the created record.

If any errors occur during processing, and "continue on fail" is enabled, the output will include error details per failed item instead of stopping execution.

No binary data output is indicated.

Dependencies

  • Requires an API key credential for authenticating with Feishu’s platform.
  • Needs proper configuration of the Feishu App token and table ID.
  • Relies on Feishu’s multi-dimensional table API endpoint for adding records.
  • The node uses internal helper methods to construct metadata and handle errors.

Troubleshooting

  • Common issues:

    • Invalid or expired App token or table ID causing authentication failures.
    • Malformed JSON in the request body leading to API rejections.
    • Incorrect user ID type causing mismatches in user-related fields.
    • Idempotency token misuse resulting in unexpected updates or duplicate entries.

  • Error messages:

    • Errors thrown by the Feishu API will be surfaced as node errors with messages describing the issue.
    • If "continue on fail" is disabled, the node stops at the first error; enabling it allows partial success.
    • Network or permission errors may require checking API credentials and network connectivity.

Links and References

Discussion