All Products
Search
Document Center

Direct Mail:CreateMailAddress

Last Updated:Mar 13, 2024

Creates a sender address.

Note: The address of the entry is not case sensitive. The system will automatically convert it to lowercase.

Debugging

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

test1***@example.net

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.

Examples

Sample requests

http(s)://dm.aliyuncs.com/? Action=CreateMailAddress
&Sendtype=batch
&AccountName=test***@example.net
&<Common request parameters>

Sample success responses

XML format

<CreateMailAddressResponse>
      <RequestId>95A7D497-F8DD-4834-B81E-C1783236E55F</RequestId>
      <MailAddressId>xxxx</MailAddressId>
</CreateMailAddressResponse>

JSON format

{
	"MailAddressId":"xxxx",
	"RequestId":"95A7D497-F8DD-4834-B81E-C1783236E55F"
}

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, please visit the API Error Center.