更新业务邮箱 - 接口文档 - 企业微信开发者中心

开发者中心

首页

教程

接口

社区

工具

企业内部开发

快速入门服务端API 客户端API 附录更新日志联系我们

企业内部开发服务端API 邮件管理业务邮箱更新业务邮箱

更新业务邮箱

最后更新：2022/12/01

该接口用于更新业务邮箱，支持更新名称、使用权限。需要注意的是Json数组类型传空值将会清空其内容，不传则保持不变。
例如清空userid_list:

{
  "id": 1,
  "name": "apitest",
  "userid_list" : {"list" : []}
  // 省略
}

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

{
  "id": 1,
  "name": "apitest"
  // 省略
}

请求方式：POST（HTTPS）
请求地址: https://qyapi.weixin.qq.com/cgi-bin/exmail/publicmail/update?access_token=ACCESS_TOKEN

请求包体

{
  "id" : 1,
  "name": "apitest",
  "userid_list": {
    "list": ["apitest1", "apitest2"]
  },
  "department_list": {
    "list": [1, 2]
  },
  "tag_list": {
    "list": [1, 2]
  }
}

参数说明

参数	类型	是否必须	说明
id	uint32	是	业务邮箱ID
name	string	否	业务邮箱名称，不多于64个字符或32个汉字，不得与其他业务邮箱重名
userid_list	string	否	有权限使用业务邮箱的成员UserID列表，不传则不变，传空为清空。userid_list、department_list、taglist不能同时为空，(使用成员不允许全部清空)
department_list	uint32	否	有权限使用业务邮箱的部门列表，不传则不变，传空为清空
tag_list	uint32	否	有权限使用业务邮箱的标签列表，不传则不变，传空为清空

权限说明

自建应用需配置到“可调用应用”列表中的应用secret所获取的accesstoken来调用（accesstoken如何获取？）
应用调用接口只能访问自身创建的业务邮箱

返回示例

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

参数说明

参数	类型	说明
errcode	int32	错误码
errmsg	string	错误码说明

创建业务邮箱

删除业务邮箱

本节内容

更新业务邮箱