该接口用于创建新邮件群组,可以指定群组成员,定义群组使用权限范围。
请求方式:POST(HTTPS)
请求地址: https://qyapi.weixin.qq.com/cgi-bin/exmail/group/create?access_token=ACCESS_TOKEN
请求包体
{
"groupid": "zhangsangroup@gzdev.com",
"groupname": "zhangsangroup",
"email_list": {
"list": ["lisi@gzdev.com", "wangwu@gzdev.com"]
},
"tag_list": {
"list": [2, 5]
},
"department_list": {
"list": [1, 2]
},
"group_list": {
"list": ["aaa@gzdev.com"]
},
"allow_type": 3,
"allow_emaillist": {
"list": ["zhangsanp@gzdev.com"]
},
"allow_departmentlist": {
"list": [1, 2]
},
"allow_taglist": {
"list": [1, 3]
}
}
参数说明
参数 | 类型 | 是否必须 | 说明 |
---|---|---|---|
groupid | string | 是 | 邮件群组ID,邮箱格式 |
groupname | string | 是 | 邮件群组名称,不能与其他群组重名,长度限定64字节 |
email_list | string | 否 | 群组内成员邮箱地址,读取成员的biz_mail字段,email_list,group_list,department_list,tag_list至少填写一个,不可同时为空。成员由email_list,group_list,department_list,tag_list共同组成 |
tag_list | uint32 | 否 | 群组内包含的标签ID |
department_list | uint32 | 否 | 群组内包含的部门ID |
group_list | string | 否 | 群组内包含的群组邮箱 |
allow_type | uint32 | 否 | 群组使用权限。0: 企业成员, 1任何人, 2:组内成员,3:自定义成员。当值为0、1、2时,不得传入allow_emaillist,allow_departmentlist,allow_taglist。当值为3时,必须传入allow_emaillist,allow_departmentlist,allow_taglist至少一项 |
allow_emaillist | string | 否 | 允许使用群组群发的成员邮箱地址,读取成员的biz_mail字段 |
allow_departmentlist | uint32 | 否 | 允许使用群组群发的部门ID |
allow_taglist | uint32 | 否 | 允许使用群组群发的标签ID |
权限说明
返回示例
{
"errcode": 0,
"errmsg": "ok"
}
参数说明
参数 | 类型 | 说明 |
---|---|---|
errcode | int32 | 错误码 |
errmsg | string | 错误码说明 |