更新邮件群组

POST

https://qyapi.weixin.qq.com/cgi-bin/exmail/group/update

该接口用于更新邮件群组，可以修改群组名称、群组成员、群组使用权限等。需要注意的是Json数组类型传空值将会清空其内容，不传则保持不变。
例如清空email_list:

{
  "groupid": "zhangsangroup@gzdev.com",
  "groupname": "zhangsangroup",
  "email_list" : {"list" : []}
  // 省略
}

若需保持不变则不传即可:

{
  "groupid": "zhangsangroup@gzdev.com",
  "groupname": "zhangsangroup"
  // 省略
}

权限说明

自建应用需配置到“可调用应用”列表中的应用secret所获取的accesstoken来调用（accesstoken如何获取？）

应用调用接口只能访问自身创建的邮件群组

请求参数

Query 参数

Body 参数application/json

示例

返回响应

🟢200成功

application/json

Body

请求示例

Shell

JavaScript

Java

Swift

curl --location --request POST 'https://qyapi.weixin.qq.com/cgi-bin/exmail/group/update' \
--header 'Content-Type: application/json' \
--data-raw '{
  "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]
  }
}'

响应示例

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

修改于 2022-12-02 06:09:13

创建邮件群组

删除邮件群组