Feishu Node icon

Feishu Node

Feishu Node

Actions106

Overview

This node integrates with the Feishu platform to manage multi-dimensional tables ("多维表格"). Specifically, the "新增字段" (Add Field) operation allows users to add a new field/column to an existing multi-dimensional table within Feishu. This is useful for dynamically extending the schema of a table by adding custom fields as needed.

Common scenarios include:

  • Automating the extension of data tables in Feishu when new data attributes are required.
  • Programmatically managing table schemas without manual intervention in the Feishu UI.
  • Integrating Feishu tables with other systems where fields need to be added based on external triggers or workflows.

Example: Automatically adding a "Status" field to a project tracking table whenever a new project type is introduced.

Properties

Name Meaning
多维表格 Token The unique identifier token for the Feishu multi-dimensional table app. Used to authenticate and specify which app instance to operate on.
多维表格 ID The unique identifier of the specific multi-dimensional data table within the Feishu app where the new field will be added.
操作的唯一标识 A unique client token used for idempotency. If empty, a new request is initiated; if provided, it ensures the update operation is idempotent by matching the token returned from previous API calls.
请求体JSON JSON object describing the new field to add. It must follow the structure defined by Feishu's API, e.g., specifying field_name (the name of the new field) and type (the field type). See Feishu API docs for details.

Output

The node outputs JSON data representing the response from the Feishu API after attempting to add the new field. This typically includes confirmation of the created field, its properties, and any metadata returned by the API.

If the operation fails, error information is included in the output JSON.

No binary data output is involved in this operation.

Dependencies

  • Requires valid Feishu API credentials configured in n8n to authenticate requests.
  • Depends on Feishu's multi-dimensional table API endpoints.
  • The node expects the user to provide correct tokens (多维表格 Token, 多维表格 ID) and properly formatted JSON body according to Feishu's API specification.

Troubleshooting

  • Common Issues:

    • Invalid or expired tokens leading to authentication failures.
    • Malformed JSON in the "请求体JSON" property causing API request errors.
    • Using a non-existent table ID or app token resulting in resource not found errors.
    • Idempotency token misuse causing unexpected behavior or duplicate operations.

  • Error Messages:

    • Errors thrown by the node include detailed messages from the Feishu API.
    • If the node encounters an API error, it throws a structured error that can be caught or logged.
    • To resolve errors, verify all tokens and IDs, ensure JSON body matches API requirements, and check network connectivity.

Links and References

This summary is based solely on static analysis of the provided source code and property definitions.

Discussion