All Products
Search
Document Center

:ModifyMailAddress

Last Updated:Oct 29, 2025

You can call the ModifyMailAddress operation to set the SMTP password and reply-to address for a sender address.

Test

You can test this operation in OpenAPI Explorer. After a successful call, OpenAPI Explorer automatically calculates the signature and generates software development kit (SDK) code examples.

Request parameters

Name

Type

Required

Example

Description

MailAddressId

Integer

Yes

1344565

The ID of the sender address.

Action

String

No

ModifyMailAddress

A required parameter. Set the value to ModifyMailAddress.

Password

String

No

DM1mail1234

The password.

  • The password must be 10 to 20 characters in length and contain digits, uppercase letters, and lowercase letters.

  • It must contain at least two digits, two uppercase letters, and two lowercase letters. The digits and letters cannot be composed of a single repeating character.

  • The password cannot be the same as the last one you set.

ReplyAddress

String

No

a***@example.net

The reply-to address.

Response data

Name

Type

Example

Description

RequestId

String

10A1AD70-E48E-476D-98D9-39BD92193837

The request ID.

Examples

Request example

http(s)://dm.aliyuncs.com/?Action=ModifyMailAddress
&MailAddressId=1344565
&<Common request parameters>

Response examples

XML format

<ModifyMailAddressResponse>
    <RequestId>10A1AD70-E48E-476D-98D9-39BD92193837</RequestId>
</ModifyMailAddressResponse>

JSON format

{    "RequestId":"10A1AD70-E48E-476D-98D9-39BD92193837"}

Error codes

HttpCode

Error code

Error message

Description

400

InvalidMailAddressSendType.Malformed

The specified mailAddress sendType is wrongly formed.

The send type is incorrect. Go to the console, check the type, and set the correct value.

400

InvalidMailAddressDomain.Malformed

The specified mailAddress domain does not exist.

The domain name format is incorrect. Use only digits, letters, underscores (_), hyphens (-), and periods (.).

400

InvalidMailAddressStatus.Malformed

The specified mailAddress status is wrongly formed.

The status of the sender address is invalid. Check if the address is active or frozen.

For more information about error codes, see the Error Center.