创建部门

调用该接口创建部门。

请求

基本
请求方式POST
请求地址/openapi/v3/contacts/departments

请求头

名称类型必填描述
Authorizationstring值格式Bearer {{access_token}}

调用 API 时,需要通过访问凭证(access_token)进行身份鉴权,不同类型的访问凭证可获取的数据范围不同,参考 获取访问凭证

支持鉴权类型:
应用级token:以应用身份调用 API,校验应用的数据访问范围。参考 获取企业内部应用access_token
用户级token:以登录用户身份调用 API,校验用户的可见数据范围。参考 获取登录用户access_token
Content-Typestring固定值:application/json; charset=utf-8

请求参数

名称类型必填描述
department_namestring部门名称
parent_idstring父部门ID
managersarray部门负责人ID数组
orderinteger部门排序

请求体示例

1{
2 "department_name": "",
3 "parent_id": "",
4 "managers": ["union_id1", "union_id2"],
5 "order": 11
6}

响应

响应体

1{
2 "code": 0,
3 "data": {
4 "department_id": "string"
5 },
6 "msg": "ok",
7 "trace_id": "ae4bd3d6d939f7790fa354e2402450e0"
8}