创建邮件群组
请求说明:
HTTPS请求方式: POST
请求地址: https://api.exmail.qq.com/cgi-bin/group/create?access_token=ACCESS_TOKEN
请求包结构体为:
{
"groupid": "zhangsangroup@gzdev.com",
"groupname": "zhangsangroup",
"userlist": ["zhangsanp@gzdev.com","lisi@gzdev.com"],
"taglist": [2,5],
"department": [1,2],
"grouplist":["aaa@gzdev.com"],
"allow_type":3,
"allow_userlist":["zhangsanp@gzdev.com"],
"allow_department":[1630648871374,1630248871372],
"allow_taglist":[1,3]
}
参数说明:
参数 | 必须 | 说明 |
---|---|---|
access_token | 是 | 调用接口凭证 |
groupid | 是 | 邮件群组id,邮件格式 |
groupname | 否 | 邮件群组名称 |
userlist | 否 | 成员帐号。userlist,grouplist,department,taglist至少填写一个,不可同时为空。成员由userlist,grouplist,department,taglist共同组成 |
taglist | 否 | 标签id。userlist,grouplist,department,taglist至少填写一个,不可同时为空。成员由userlist,grouplist,department,taglist共同组成 |
grouplist | 否 | 邮件群组账号。userlist,grouplist,department,taglist至少一个,不可同时为空。成员由userlist,grouplist,department,taglist共同组成 |
department | 否 | 部门id。userlist,grouplist,department,taglist至少一个,不可同时为空。成员由userlist,grouplist,department,taglist共同组成 |
allow_type | 否 | 群发权限。0: 企业成员, 1任何人, 2:组内成员,3:自定义成员。当值为0、1、2时,不得传入allow_userlist,allow_department,allow_taglist。当值为3时,必须传入allow_userlist,allow_department,allow_taglist至少一项。 |
allow_userlist | 否 | 群发权限为指定成员时,需要指定成员 |
allow_department | 否 | 群发权限为指定部门时,需要指定部门 |
allow_taglist | 否 | 群发权限为指定标签时,需要指定标签 |
权限说明
系统应用须拥有邮件群组的写管理权限。
返回结果
{
"errcode": 0,
"errmsg": "created"
"invalid_userlist": [],
"invalid_departlist": [],
"invalid_taglist": [],
"invalid_grouplist":[]
}
参数 | 说明 |
---|---|
errcode | 返回码 |
errmsg | 对返回码的文本描述内容 |
invalid_userlist | 所有非法的user账号 |
invalid_departlist | 所有非法的部门ID |
invalid_taglist | 所有非法的标签ID |
invalid_grouplist | 所有非法的邮件群组ID |