创建用户邮箱别名

POST

/mail/v1/user_mailboxes/{user_mailbox_id}/aliases

创建用户邮箱别名。

错误码

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

请求参数

Authorization

Bearer Token

在 Header 添加参数

Authorization

，其值为在 Bearer 之后拼接 Token

示例：

Authorization: Bearer ********************

Path 参数

Body 参数application/json

示例

返回响应

🟢200成功

application/json

Body

请求示例

Shell

JavaScript

Java

Swift

curl --location --request POST '/mail/v1/user_mailboxes//aliases' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data-raw '{
    "email_alias": "xxx@xx.xxx"
}'

响应示例

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

修改于 2025-10-21 07:43:48

从回收站删除用户邮箱地址

删除用户邮箱别名

创建用户邮箱别名

错误码#

请求参数

返回响应

错误码