企业内部开发 服务端API 通讯录管理 部门管理 创建部门
创建部门

请求方式:POST(HTTPS
请求地址:https://qyapi.weixin.qq.com/cgi-bin/department/create?access_token=ACCESS_TOKEN

请求包体:

{
   "name": "广州研发中心",
   "name_en": "RDGZ",
   "parentid": 1,
   "order": 1,
   "id": 2
}

参数说明:

参数必须说明
access_token调用接口凭证
name部门名称。同一个层级的部门名称不能重复。长度限制为1~32个字符,字符不能包括:*?"<>|
name_en英文名称。同一个层级的部门名称不能重复。需要在管理后台开启多语言支持才能生效。长度限制为1~32个字符,字符不能包括:*?"<>|
parentid父部门id,32位整型
order在父部门中的次序值。order值大的排序靠前。有效的值范围是[0, 2^32)
id部门id,32位整型,指定时必须大于1。若不填该参数,将自动生成id

权限说明:

第三方仅通讯录应用可以调用。

注意,部门的最大层级为15层;部门总数不能超过3万个;每个部门下的节点不能超过3万个。建议保证创建的部门和对应部门成员是串行化处理。

返回结果:

{
   "errcode": 0,
   "errmsg": "created",
   "id": 2
}

参数说明:

参数说明
errcode返回码
errmsg对返回码的文本描述内容
id创建的部门id
上一篇
邮箱获取userid
下一篇
更新部门