创建邮件组别名

创建邮件组别名。

请求

项目	值
HTTP URL	https://open.feishu.cn/open-apis/mail/v1/mailgroups/:mailgroup_id/aliases
HTTP Method	POST
接口频率限制	1000 次/分钟、50 次/秒
支持的应用类型	custom
权限要求 调用该 API 所需的权限。开启其中任意一项权限即可调用	mail:mailgroup 查询、创建、修改、删除邮件组

请求头

名称	类型	必填	描述
Authorization	string	是	tenant_access_token 值格式："Bearer access_token" 示例值："Bearer t-7f1bcd13fc57d46bac21793a18e560" 了解更多：如何选择与获取 access token
Content-Type	string	是	固定值："application/json; charset=utf-8"

路径参数

名称	类型	描述
mailgroup_id	string	邮件组ID或邮件组邮箱地址 示例值："xxxxxx 或者 xxx@xx.xxx"

请求体

名称	类型	必填	描述
email_alias	string	否	邮箱别名 示例值："xxx@xx.xxx"

请求体示例

{
    "email_alias": "xxx@xx.xxx"
}

响应

响应体

名称	类型	描述
code	int	错误码，非 0 表示失败
msg	string	错误描述
data	\-	-
└ mailgroup_alias	email_alias	邮件组别名
└ primary_email	string	主邮箱地址
└ email_alias	string	邮箱别名

响应体示例

{
    "code": 0,
    "msg": "success",
    "data": {
        "mailgroup_alias": {
            "primary_email": "xxx@xx.xxx",
            "email_alias": "xxx@xx.xxx"
        }
    }
}

错误码

HTTP状态码	错误码	描述	排查建议
409	1234006	email address has been used	邮件地址已被占用，请使用其它邮件地址
404	1234013	mail group not found	请确认邮件组是否存在
400	1234008	request parameter error	请检查请求参数是否正确
409	1235002	email alias address has been used	别名邮件地址已被占用，请使用其它邮件地址
400	1235003	Service unavailable	请稍后重试
404	1234019	mail address's domain not found	请确认域名是否存在
409	1234033	email address has been used by another member as login account	邮件地址已被他人用作登录邮箱，请使用其它邮件地址