All Products
Search
Document Center

:CreateReceiver

Last Updated:Oct 29, 2025

Call the CreateReceiver operation to create a recipient list.

Debug

You can call this operation directly in OpenAPI Explorer. This way, you do not need to calculate signatures. After a successful call, OpenAPI Explorer automatically generates software development kit (SDK) code examples.

Request parameters

Name

Type

Required

Example

Description

ReceiversName

String

Yes

test

The name of the recipient list. The name must be unique. It can be 1 to 30 characters in length.

ReceiversAlias

String

Yes

a***@example.net

The alias of the recipient list. The alias must be an email address that is less than 30 characters in length.

Action

String

No

CreateReceiver

A required parameter. Set the value to CreateReceiver.

Desc

String

No

Description

The description of the recipient list.

Response parameters

Name

Type

Example

Description

ReceiverId

String

xxxx

The ID of the recipient list.

RequestId

String

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

The request ID.

Examples

Request example

http(s)://dm.aliyuncs.com/?Action=CreateReceiver
&ReceiversAlias=vme
&ReceiversName=xme
&<Common request parameters>

Examples of successful responses

XML format

<CreateReceiverResponse>
	  <RequestId>10A1AD70-E48E-476D-98D9-39BD92193837</RequestId>
	  <ReceiverId>xxxx</ReceiverId>
</CreateReceiverResponse>

JSON format

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

Error codes

HTTP status code

Error code

Error message

Description

400

InvalidReceiverName.Malformed

The specified receiver name is wrongly formed.

The recipient address is in an invalid format. The address must contain an at sign (@). The account name and domain name can contain only digits, letters, underscores (_), hyphens (-), and periods (.).

400

InvalidReceiverStatus.Malformed

The specified receivers status is wrongly formed.

The recipient status is invalid. Go to the console to check whether the recipient is uploaded.

For more information, see Error Center.