创建部门

POST

http://127.0.0.1/cgi-bin/department/create

智慧硬件开发/通讯录管理/部门管理

最后修改时间：2022-08-30 03:03:36

责任人：未设置

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

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

文档ID: 10076
原文档地址：
https://open.work.weixin.qq.com/api/doc/90000/90135/90205
https://open.work.weixin.qq.com/api/doc/90001/90143/90341
https://open.work.weixin.qq.com/api/doc/90002/90151/90824

请求参数

Query 参数

access_token

string

调用接口凭证

必需

示例值:

Body 参数application/json

name

string

必需

部门名称。同一个层级的部门名称不能重复。长度限制为1~32个字符，字符不能包括:*?”<>｜

integer <int32>

可选

部门id，32位整型，指定时必须大于1。若不填该参数，将自动生成id

parentid

integer <int32>

必需

父部门id，32位整型

name_en

string

可选

英文名称。同一个层级的部门名称不能重复。需要在管理后台开启多语言支持才能生效。长度限制为1~32个字符，字符不能包括:*?”<>｜

order

integer <int32>

可选

在父部门中的次序值。order值大的排序靠前。有效的值范围是[0, 2^32)

示例

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

示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location -g --request POST 'http://127.0.0.1/cgi-bin/department/create?access_token={{accesstoken}}' \
--header 'Content-Type: application/json' \
--data-raw '{
    "name": "广州研发中心",
    "name_en": "RDGZ",
    "parentid": 1,
    "order": 1,
    "id": 2
}'

返回响应

🟢200成功

application/json

Body

errcode

integer <int32>

返回码

可选

errmsg

string

可选

对返回码的文本描述内容

integer <int32>

创建的部门id

可选

示例

{
  "errcode": 0,
  "errmsg": "string",
  "id": 0
}

邀请成员

更新部门