All Products
Search
Document Center

:SaveReceiverDetail

Last Updated:Oct 29, 2025

Create a single recipient

Description

Creates a single recipient.

Request parameters

Name

Type

Required

Description

Action

String

Yes

A required parameter. Set the value to SaveReceiverDetail.

ReceiverId

String

Yes

The ID of the recipient list.

Detail

String

Yes

The content. You can upload multiple recipients at a time, with a limit of 500 records per upload. Each record is enclosed in curly braces `{}` and separated by a comma. Example:

[{ },{ },{ }...]. The format of the content within {} is as follows:

[{"b":"birthday","e":"xxx@example.net","g":"gender","m":"mobile","n":"nickname","u":"name"}]. Pass the value as a string, not a list.

If you insert a duplicate recipient address, the operation returns an error: "ErrorCount": 1.

For information about other request parameters, see Common request parameters.

Response parameters

Name

Type

Example

Description

ErrorCount

Integer

638

The number of errors.

RequestId

String

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

The ID of the request.

SuccessCount

Integer

274

The number of successful operations.

Data

Object []

A list of email addresses that failed to upload.

Email

String

te**@example.net

The email address.

Examples

Example request

http(s)://dm.aliyuncs.com/?Action=SaveReceiverDetail
&ReceiverId=34642
&Detail=[{"b":"birthday","e":"xxx@example.net","g":"gender","m":"mobile","n":"nickname","u":"name"}]
&<Common request parameters>

Example response

JSON format

{
  "RequestId": "CA225B85-DC42-520D-84A3-0B8FF424CA9C",
  "Data": {
    "Detail": []
  },
  "ErrorCount": 0,
  "SuccessCount": 1
}

Example error response

{
  "RequestId": "1A32A629-49E4-52C6-ACA9-E5ED77A7A53B",
  "Data": {
    "Detail": [
      {
        "Email": "xxx@example.net"
      }
    ]
  },
  "ErrorCount": 1,
  "SuccessCount": 0
}