登录
基础
连接微信
办公
请求方式：POST（HTTPS）
请求地址：https://qyapi.weixin.qq.com/cgi-bin/school/department/create?access_token=ACCESS_TOKEN
请求包体：
{
"name": "一年级",
"parentid": 5,
"id": 2,
"type": 1,
"register_year":2018,
"standard_grade":1,
"order":1,
"department_admins": [
{
"userid": "zhangsan",
"type": 4,
"subject":"语文"
},
{
"userid": "lisi",
"type": 3,
"subject":"数学"
}
]
}
参数说明：
| 参数 | 必须 | 说明 |
|---|---|---|
| access_token | 是 | 调用接口凭证 |
| name | 否 | 部门名称。长度限制为1~32个字符，字符不能包括-:*?"<>/，*，当设置了入学年份和标准年级时，该参数将被忽略 |
| parentid | 是 | 父部门id，32位整型 |
| id | 否 | 部门id，32位整型，指定时必须大于1。若不填该参数，将自动生成id |
| type | 是 | 部门类型，32位整型，1表示班级，2表示年级，3表示学段，4表示校区 |
| standard_grade | 否 | 标准年级，32位整型，参数值含义详见标准年级对照表，仅当部门类型为年级（2）时生效 |
| register_year | 否 | 入学年份，32位整型，格式为YYYY，输入范围为1970～2100，仅当部门类型为年级（2）时生效，如果在创建标准年级时不填此参数，则由系统自动计算出入学年份 |
| order | 否 | 在父部门中的次序值。order值大的排序靠前。有效的值范围是[0, 2^32) |
| department_admins | 否 | 部门管理员列表 |
| department_admins.userid | 是 | 对应管理端的账号，企业内必须唯一。不区分大小写，长度为1~64个字节 |
| department_admins.type | 是 | 部门管理员类型， 1表示校区负责人，2表示年级负责人，3表示班主任，4表示任课老师，5表示学段负责人 |
| department_admins.subject | 否 | 教师的科目，仅班主任和任课老师可以设置，科目的最多15个字符，仅支持设置一个科目 |
注意，班级的父部门必须是年级，也就是说type为1的部门的父部门type值必须是2。
如果创建的标准年级为小学二年级，当前为2019年，则系统默认的入学年份为2018年，依次类推。
管理员类型须与部门类型保持一致，即校区负责人只能配置到校区部门，班主任和任课老师只能设置到班级。
权限说明：
调用的应用需要满足如下的权限
| 应用类型 | 权限要求 |
|---|---|
| 自建应用 | 配置到「 家校沟通- 读取和编辑家校通讯录的应用」中 |
| 代开发应用 | 需拥有「家校沟通」可使用家校通讯录-家校通讯录编辑 权限 |
| 第三方应用 | 需拥有「家校沟通」使用和编辑 权限 |
注： 从2023年12月1日0点起，不再支持通过系统应用secret调用接口，存量企业暂不受影响 查看详情
返回结果：
{
"errcode": 0,
"errmsg": "created",
"id": 2
}
参数说明：
| 参数 | 说明 |
|---|---|
| errcode | 返回码 |
| errmsg | 对返回码的文本描述内容 |
| id | 创建的部门id |
基础连接微信办公基础连接微信办公基础连接微信办公