Creates a sender address.


OpenAPI Explorer automatically calculates the signature value. For your convenience, we recommend that you call this operation in OpenAPI Explorer. OpenAPI Explorer dynamically generates the sample code of the operation for different SDKs.

Request parameters

Parameter Type Required Example Description
AccountName String Yes <Account name>+@+<domain name>

The sender address.

Sendtype String Yes batch

The email type. Valid values:

  • batch: batch emails
  • trigger: triggered emails
AccessKeyId String No xxx

The AccessKey ID provided to you by Alibaba Cloud.

Action String No CreateMailAddress

The operation that you want to perform. Set the value to CreateMailAddress.

ReplyAddress String No

The reply-to address.

Response parameters

Parameter Type Example Description
MailAddressId String  xxx

The ID of the sender address.

RequestId String 95A7D497-F8DD-4834-B81E-C1783236E55F

The ID of the request.


Sample requests

http(s):// Action=CreateMailAddress
&<Common request parameters>

Sample success responses

XML format


JSON format


Error codes

HTTP status code Error code Error message Description
400 InvalidMailAddressSendType.Malformed The specified mailAddress sendType is wrongly formed. The error message returned because the specified email type is invalid. Log on to the console and select a valid email type.
400 InvalidMailAddressDomain.Malformed The specified mailAddress domain does not exist. The error message returned because the format of the domain name is invalid. A domain name must contain digits, letters, underscores (_), hyphens (-), and periods (.).
400 InvalidMailAddressStatus.Malformed The specified mailAddress status is wrongly formed. The error message returned because the status of the sender address is invalid. Check whether the sender address is frozen.

For a list of error codes, visit the API Error Center.