新建文件夹

​

一、指令概述

该 RPA 指令用于在飞书云盘创建新文件夹，支持在根目录或指定父文件夹下生成文件夹，返回新文件夹的唯一标识（Token）和访问链接，适用于飞书云盘文件分类管理、自动化归档等场景。 飞书官方开发文档参考：https://open.feishu.cn/document/server-docs/docs/drive-v1/folder/create_folder

​

二、调用参数配置示意

参数名称示例 / 默认值说明指令新建文件夹固定选择 “新建文件夹”，执行飞书云盘文件夹创建操作。飞书访问凭证飞书访问凭证配置飞书开放平台的访问凭证（需具备文件夹创建权限，可通过 “获取飞书访问凭证” 指令生成），支持变量（界面显示 “{x}” 标识）。文件夹 Token（空 /fldbc****************）输入父文件夹的唯一标识 Token（可选，不填则在飞书云盘根目录创建新文件夹），关键字符已打码，支持变量。文件夹名称2025Q4报表输入新建文件夹的名称（需符合飞书云盘命名规范，支持变量）。生成的变量 - 运行结果变量3（自定义变量名）存储新建文件夹操作的执行结果（包含新文件夹的 Token 和访问链接），需配置为自定义变量，后续流程可调用，支持变量。

​

三、使用示例（在指定父文件夹下新建文件夹场景）

​

场景：在飞书云盘父文件夹（Token：fldbc****************）下，创建名为 “2025Q4 报表” 的新文件夹。

​

参数配置：

• 指令：新建文件夹 • 飞书访问凭证：feishuAuthToken（通过 “获取飞书访问凭证” 指令生成的变量） • 文件夹 Token：fldbc****************（父文件夹唯一标识，关键字符已打码） • 文件夹名称：2025Q4报表 • 运行结果：createFolderResult（自定义变量，存储创建结果）

​

执行流程：

调用该 RPA 指令后，RPA 会通过 feishuAuthToken 完成飞书 API 认证，根据打码后的父文件夹 Token 和文件夹名称，在指定位置创建新文件夹；创建完成后，将包含新文件夹 Token 和访问链接的结果存入 createFolderResult 变量，便于后续文件移动、分类管理等操作引用该文件夹。

​

四、返回结果说明

​

飞书 API 标准返回示例（成功场景）：

指令执行后，“运行结果” 变量（如createFolderResult）会存储包含新文件夹信息的 JSON 结果，格式如下： { “code”: 0, “msg”: “success”, “data”: { “token”: “fldbcddUuPz8VwnpPx5oc2abcef”, “url”: “https://feishu.cn/drive/folder/fldbcddUuPz8VwnpPx5oc2abcef” }}

​

响应字段含义：

• code：状态码，0 表示文件夹创建成功，非 0 为失败（具体错误码含义参考飞书官方文档）。 • msg：提示信息，success 表示创建成功。 • data：核心返回数据： ◦ token：新文件夹的唯一标识 Token（用于后续文件夹操作的身份关联，如移动文件、创建子文件夹等）； ◦ url：新文件夹的飞书云盘访问链接，可直接跳转至该文件夹页面。

​

五、注意事项

1. 访问凭证权限：“飞书访问凭证” 需具备文件夹创建权限（如 “Create folder” 权限）且未过期，否则会返回 code=403（权限不足）错误。
2. 文件夹名称规范性：文件夹名称需符合飞书云盘命名规则（不可包含非法字符、长度需在限制范围内），否则会返回创建失败（如code=1062501 名称无效错误）。
3. 父文件夹 Token 有效性：若填写 “文件夹 Token”，需确保其为飞书云盘合法存在的文件夹 Token（打码不影响实际值校验），否则会返回 code=404（父文件夹不存在）错误。
4. 创建频率限制：飞书 API 对文件夹创建操作有频率限制，避免短时间内批量创建过多文件夹，否则可能触发限流（code=1061045），需合理控制调用节奏。

​

六、延伸应用

可结合 RPA 的 “移动文件”“新建文件夹” 指令，实现飞书云盘自动化分类归档：例如根据业务周期（如季度、月份）自动创建 “2025Q4 报表”“2025Q4 素材” 等文件夹，再调用 “移动文件” 指令将对应周期的文件自动移动到新建文件夹中，替代人工手动创建和整理文件夹的重复工作，提升云盘管理效率。