Feishu Node

Actions61

Overview

This node allows you to create a new block (content section) within a Feishu (Lark) cloud document. It is designed for integration with the Feishu Docs API, specifically for adding content blocks under a specified parent block or at the root of a document. This is useful in scenarios where you need to programmatically build or update structured documents, such as generating reports, collaborative editing, or automating documentation workflows.

Practical examples:

Automatically appending meeting notes to a shared document.
Creating structured templates in Feishu Docs from other n8n workflow data.
Adding sections to project documentation based on external triggers.

Properties

Name	Type	Meaning
文档 ID	String	The unique identifier of the document where the block will be created.
父块 ID	String	The block_id of the parent block under which new child blocks are created. To add a block at the root, use the document_id here.
文档版本	Number	The version of the document to target. Use -1 for the latest version.
操作的唯一标识	String	A unique identifier for the operation, used for idempotency. Leave empty for a new request; provide a value to ensure repeated requests do not duplicate actions.
用户 ID 类型	Options	The type of user ID to use. Options: Open_id, Union_id, User_id.
请求体JSON	JSON	The request body in JSON format, specifying the details of the block(s) to create. See Feishu API docs for structure.

Output

The node outputs an array of objects in the json field. Each object contains the response from the Feishu API for the block creation operation. If an error occurs and "Continue On Fail" is enabled, the output will include an error field with the error message (and additional error details if available).

Example output (success):

[
  {
    "json": {
      // ...fields returned by Feishu API, e.g., block_id, etc.
    }
  }
]

Example output (error, with Continue On Fail):

[
  {
    "json": {
      "error": "Error message from Feishu API"
    }
  }
]

Dependencies

External Service: Requires access to the Feishu (Lark) Docs API.
Credentials: Needs n8n credentials named feishuCredentialsApi.
Environment: No special environment variables required beyond n8n credential configuration.

Troubleshooting

Missing Method Error:
If you see an error like 未实现方法: doc.doc:block:create, it means the selected resource/operation combination is not implemented in the node.
API Errors:
If the Feishu API returns an error (e.g., invalid document ID, permission denied), the error message will appear in the output. Check that your credentials are correct and that the document/block IDs exist and are accessible.
Idempotency Issues:
If using the "操作的唯一标识" property, ensure you provide a truly unique value for each distinct operation to avoid accidental duplication or missed updates.