一、指令概述
该指令用于在钉钉钉盘指定目录下创建文件夹，支持自定义文件夹名称与应用属性；若同名文件夹已存在，直接返回已有文件夹 ID，避免重复创建，适用于钉盘目录初始化、自动归档、业务文件夹批量搭建等自动化场景。
可查看官方文档： https://open.dingtalk.com/document/development/add-folder
二、核心参数配置
| 参数名称 | 说明 | 输入格式 / 规则 |
| 凭证 | 钉钉开放平台接口调用凭证（access_token） | 必填；通过「获取开发平台凭证」指令获取 |
| 用户 Id | 操作人的钉钉用户 ID | 必填；可通过「查询用户 Id」指令获取 |
| space_id | 钉盘空间 ID | 必填；通过「获取空间列表」指令获取，指定目标钉盘空间 |
| 父目录 Id | 目标父目录 ID | 必填；0代表用户空间根目录，填写具体 ID 则在对应子目录下创建 |
| 文件夹名称 | 待创建的文件夹名称 | 必填；自定义合法文件夹名，支持中文、数字、英文 |
| 应用属性名称 | 自定义扩展属性名 | 选填；用于给文件夹添加业务自定义标签 |
| 应用属性值 | 自定义扩展属性值 | 选填；与应用属性名称配对使用 |
| 生成变量【文件夹 Id】 | 存储结果的输出变量 | 必填；返回文件夹唯一 ID，新建 / 已存在均返回有效 ID |
三、典型操作示例
· 凭证：ding_access_token_xxxx
· 用户 Id：m4PgPMMZNiijuStvkgQD2VAiEiE
· space_id：28821244xxx
· 父目录 Id：0
· 文件夹名称：2026年业务归档
· 应用属性名称：业务类型
· 应用属性值：销售数据
· 输出变量：new_folder_id
· 执行效果：在钉盘根目录创建2026年业务归档文件夹，自动添加自定义业务标签；若已存在，直接返回已有文件夹 ID。
输出结果：
五、注意事项
1. 权限校验：操作人必须拥有目标钉盘、父目录的创建权限，否则创建失败；