服务商代开发
基础
数据与智能专区
应用接收专区通知
连接微信
客户联系
办公
服务商代开发
服务端API
家校沟通
学生与家长管理
创建家长
创建家长
最后更新:2024/08/22

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

请求包体:

{
	"parent_userid": "zhangsan_parent_userid",
    "mobile": "10000000000",
	"to_invite": false,
	"children":[
		{
			"student_userid": "zhangsan",
            "relation": "爸爸"
        },
        {
			"student_userid": "lisi",
            "relation": "伯父"
        }
     ]
}

参数说明:

参数必须说明
access_token调用接口凭证。获取方法查看“获取access_token
parent_userid家长UserID。学校内必须唯一,可以与企业通讯录内成员UserID相同。不区分大小写,长度为1~64个字节。只能由数字、字母和“_-@.”四种字符组成,且第一个字符必须是数字或字母。
mobile家长手机号
to_invite是否发起邀请,默认为true,仅验证的学校才能发起邀请。
children家长的孩子列表,最多10
children.student_userid学生的UserID
children.relation家长与学生的关系,最长32字节
当参数字段超过长度限制,那么整个请求会被拦掉。

权限说明:

调用的应用需要满足如下的权限

应用类型权限要求
自建应用配置到「 家校沟通-读取和编辑家校通讯录的应用」中
代开发应用需拥有「家校沟通」可使用家校通讯录-家校通讯录编辑 权限
第三方应用需拥有「家校沟通」使用和编辑 权限

注: 从2023年12月1日0点起,不再支持通过系统应用secret调用接口,存量企业暂不受影响 查看详情

返回结果:

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

参数说明:

参数说明
errcode返回码
errmsg对返回码的文本描述内容
上一篇批量更新学生
下一篇删除家长
    本节内容
服务端API
基础
数据与智能专区
应用接收专区通知
连接微信
客户联系
办公
客户端API
小程序
基础
连接微信
办公
WECOM-JSSDK
JS-SDK
基础
连接微信
办公
更新日志
联系我们