飞书Install

Summary

创建飞书云文档中的一批子块。指定文档、父块和请求体 JSON；将父块 ID 设为文档 ID 可在文档根节点创建子块。

Inputs

• 凭证类型 — 选择用户级别凭证或应用级别凭证；默认使用应用级别凭证。
• 文档 ID (required) — 要添加块的云文档唯一标识。
• 父块 ID (required) — 新块的父块标识；要在文档树根节点创建块时，填入文档 ID。
• 文档版本 — 文档版本号，默认 -1，表示最新版本。
• 操作的唯一标识 — client_token，用于幂等请求；留空时发起新请求。
• 用户 ID 类型 — 用户标识类型：open_id、union_id 或 user_id，默认 open_id。
• 请求体 JSON — 传给飞书创建文档块接口的 JSON 请求体，默认 {}。按飞书 API 格式提供要创建的块及相关数据。
• Options — 可选配置请求超时；也可添加 Batching 以并发处理输入项，每批默认 50 项，批次间隔默认 1000 毫秒。

Output shape

每个输入项对应飞书 API 返回的数据对象，作为 n8n JSON 输出项。

启用 Batching 后，按配置并发发送请求，输出仍按输入项顺序处理。请求失败时通常抛出错误；启用 Continue On Fail 时输出包含 error 信息的项。

Examples

Example 1: 在文档根节点新增子块

将文档 ID 填入文档 ID 和父块 ID，并在请求体 JSON 中提供符合飞书创建块 API 的块数据。

Links

• n8n community nodes installation guide