创建部门
POST
/department/create说明
调用本接口创建新部门。
服务地址:https://oapi.dingtalk.com
权限
服务端API是以应用维度授权的,在调用接口前,确保已经为应用添加了接口权限。详情请参考权限申请。
应用类型 | 是否支持调用 | 权限申请方式 | API Explorer调试 |
---|---|---|---|
企业内部应用 | 是 | 开发者后台申请 | 调试 |
第三方企业应用 | 否 | — | — |
第三方个人应用 | 否 | — | — |
请求参数
调用服务端API授权凭证,可通过获取企业内部应用的access_token接口获取。
部门名称。长度限制为1~64个字符,不允许包含字符"-"","以及","。
父部门ID,根部门ID为1。
是否优先使用父部门的预算。
是否共享预算:true:是false:否
是否默认同意加入该部门的申请:true:表示加入该部门的申请将默认同意false:表示加入该部门的申请需要有权限的管理员同意
outerDept为true时,可以配置额外可见人,值为userid组成的的字符串,使用“|”符号进行分隔,总数不能超过200。
outerDept为true时,可以配置额外可见部门,值为部门id组成的的字符串,使用“|”符号进行分隔,总数不能超过200。
是否限制本部门成员查看通讯录:true:开启限制,开启后本部门成员只能看到限定范围内的通讯录false:不限制
是否隐藏部门:true:表示隐藏false:表示显示
是否创建一个关联此部门的企业群,默认为false。
在父部门中的次序值。order值小的排序靠前。
部门标识字段,开发者可用该字段来唯一标识一个部门,并与钉钉外部通讯录里的部门做映射。
可以查看指定隐藏部门的其他部门列表,如果部门隐藏,则此值生效,取值为其他的部门ID组成的的字符串,使用"|"符号进行分隔。总数不能超过200。
可以查看指定隐藏部门的其他人员列表,如果部门隐藏,则此值生效,取值为其他的人员userid组成的的字符串,使用"|"符号进行分隔。总数不能超过200。
是否只能看到所在部门及下级部门通讯录:true:表示只能看到所在部门及下级部门通讯录false:不能查看所在部门及下级部门通讯录outerDept为true时,可以配置该字段。
部门自定义字段,格式为文本类型的Json格式。
{
"name": "管理3部",
"parentid": "1",
"outerDept": "true",
"outerPermitUsers": "manager4220|user123",
"ext": "{\"职能\":\"总裁办\"}"
}
示例代码
返回响应
{
"errcode": 0,
"errmsg": "string",
"id": 0
}