Domain name for API request: ses.tencentcloudapi.com.
This API is used to add recipient email addresses (up to 20,000 at a time) to a recipient group. This will be processed asynchronously. If the data volume is large, it may take some time to upload. You can check the recipient group for the upload status and upload quantity. This API has basically the same feature as that of CreateReceiverDetailWithData
except that it doesn't support uploading template parameters for email sending. You need to first call the CreateReceiver
API to create a recipient group, then call this API to pass in recipient addresses, and finally call the BatchSendEmail
API to batch send emails. This API supports adding more recipient addresses during upload but not address deduplication, so you need to make sure that the recipient addresses are not duplicate by yourself. This API can request up to 20,000 recipient addresses at a time, but the recipient group can contain up to 50,000 addresses currently.
A maximum of 20 requests can be initiated per second for this API.
The following request parameter list only provides API request parameters and some common parameters. For the complete common parameter list, see Common Request Parameters.
Parameter Name | Required | Type | Description |
---|---|---|---|
Action | Yes | String | Common Params. The value used for this API: CreateReceiverDetail. |
Version | Yes | String | Common Params. The value used for this API: 2020-10-02. |
Region | Yes | String | Common Params. For more information, please see the list of regions supported by the product. |
ReceiverId | Yes | Integer | Recipient group ID |
Emails.N | Yes | Array of String | Email address |
Parameter Name | Type | Description |
---|---|---|
RequestId | String | The unique request ID, which is returned for each request. RequestId is required for locating a problem. |
POST / HTTP/1.1
Host: ses.tencentcloudapi.com
Content-Type: application/json
X-TC-Action: CreateReceiverDetail
<Common request parameters>
{
"ReceiverId": 123,
"Emails": [
"123",
"456@bc.com"
]
}
{
"Response": {
"RequestId": "8979fc1e-9564-4fc9-bf7d-2958ce679b72"
}
}
TencentCloud API 3.0 integrates SDKs that support various programming languages to make it easier for you to call APIs.
The following only lists the error codes related to the API business logic. For other error codes, see Common Error Codes.
Error Code | Description |
---|---|
FailedOperation | Operation failed. |
FailedOperation.ServiceNotAvailable | The request has not taken effect. Try again. |
InternalError | Internal error. |
InvalidParameterValue.TemplateDataError | Template parameters must be in JSON format. |
InvalidParameterValue.TemplateDataInconsistent | The name of a template parameter variable is not the same as the original name. |
LimitExceeded.ReceiverDetailCountLimit | The number of recipient addresses in the recipient group exceeds the limit. |
LimitExceeded.ReceiverDetailRequestLimit | The number of recipient addresses requested exceeds the limit. |
MissingParameter.EmailsNecessary | The recipient email address is required. |
MissingParameter.ReceiverIdNecessary | The recipient group ID is required. |
OperationDenied.ReceiverIsOperating | The recipient group is being uploaded. Try again later. |
OperationDenied.ReceiverNotExist | The recipient group does not exist. |
Was this page helpful?