- News and Announcements
- Product Introduction
- Purchase Guide
- Getting Started
- Console Guide
- API Documentation
- SMTP Documentation
- Webhook Documentation
- Email Sending Restrictions
- FAQs
- Contact Us
- News and Announcements
- Product Introduction
- Purchase Guide
- Getting Started
- Console Guide
- API Documentation
- SMTP Documentation
- Webhook Documentation
- Email Sending Restrictions
- FAQs
- Contact Us
Feature Description
If there is an Error field in the response, it means that the API call failed. For example:
{
"Response": {
"Error": {
"Code": "AuthFailure.SignatureFailure",
"Message": "The provided credentials could not be validated. Please check your signature is correct."
},
"RequestId": "ed93f3cb-f35e-473f-b9f3-0d451b8b79c6"
}
}
Code in Error indicates the error code, and Message indicates the specific information of the error.
Error Code List
Common Error Codes
| Error Code | Description |
|---|---|
| ActionOffline | This API has been deprecated. |
| AuthFailure.InvalidAuthorization | Authorization in the request header is invalid. |
| AuthFailure.InvalidSecretId | Invalid key (not a TencentCloud API key type). |
| AuthFailure.MFAFailure | MFA failed. |
| AuthFailure.SecretIdNotFound | Key does not exist. Check if the key has been deleted or disabled in the console, and if not, check if the key is correctly entered. Note that whitespaces should not exist before or after the key. |
| AuthFailure.SignatureExpire | Signature expired. Timestamp and server time cannot differ by more than five minutes. Please ensure your current local time matches the standard time. |
| AuthFailure.SignatureFailure | Invalid signature. Signature calculation error. Please ensure you’ve followed the signature calculation process described in the Signature API documentation. |
| AuthFailure.TokenFailure | Token error. |
| AuthFailure.UnauthorizedOperation | The request is not authorized. For more information, see the CAM documentation. |
| DryRunOperation | DryRun Operation. It means that the request would have succeeded, but the DryRun parameter was used. |
| FailedOperation | Operation failed. |
| InternalError | Internal error. |
| InvalidAction | The API does not exist. |
| InvalidParameter | Incorrect parameter. |
| InvalidParameterValue | Invalid parameter value. |
| InvalidRequest | The multipart format of the request body is incorrect. |
| IpInBlacklist | Your IP is in uin IP blacklist. |
| IpNotInWhitelist | Your IP is not in uin IP whitelist. |
| LimitExceeded | Quota limit exceeded. |
| MissingParameter | A parameter is missing. |
| NoSuchProduct | The product does not exist. |
| NoSuchVersion | The API version does not exist. |
| RequestLimitExceeded | The number of requests exceeds the frequency limit. |
| RequestLimitExceeded.GlobalRegionUinLimitExceeded | Uin exceeds the frequency limit. |
| RequestLimitExceeded.IPLimitExceeded | The number of ip requests exceeds the frequency limit. |
| RequestLimitExceeded.UinLimitExceeded | The number of uin requests exceeds the frequency limit. |
| RequestSizeLimitExceeded | The request size exceeds the upper limit. |
| ResourceInUse | Resource is in use. |
| ResourceInsufficient | Insufficient resource. |
| ResourceNotFound | The resource does not exist. |
| ResourceUnavailable | Resource is unavailable. |
| ResponseSizeLimitExceeded | The response size exceeds the upper limit. |
| ServiceUnavailable | Service is unavailable now. |
| UnauthorizedOperation | Unauthorized operation. |
| UnknownParameter | Unknown parameter. |
| UnsupportedOperation | Unsupported operation. |
| UnsupportedProtocol | HTTP(S) request protocol error; only GET and POST requests are supported. |
| UnsupportedRegion | API does not support the requested region. |
Service Error Codes
| Error Code | Description |
|---|---|
| FailedOperation.AttachContentToolarge | The attachments are too large. Make sure they do not exceed the size limit for a single attachment and the overall limit for all attachments. |
| FailedOperation.EmailAddrInBlacklist | The email address is in the blocklist. |
| FailedOperation.EmailContentToolarge | The email is too large. Remove some content. |
| FailedOperation.ExceedSendLimit | The number of emails exceeds the daily sending limit. |
| FailedOperation.ExceedTemplateLimit | The number of templates exceeds the upper limit. |
| FailedOperation.FrequencyLimit | You have sent too many emails to the same address in a short period. |
| FailedOperation.HighRejectionRate | The email has been blocked temporarily due to high rejection rate. |
| FailedOperation.IncorrectEmail | Incorrect email address. |
| FailedOperation.IncorrectSender | Incorrect sender format. Follow the sample in this document. |
| FailedOperation.InsufficientBalance | Insufficient balance or account in arrears. |
| FailedOperation.InsufficientQuota | Insufficient emails in plans. |
| FailedOperation.InvalidAttachName | Unsupported attachment name. Make sure it does not contain special characters. For details, see the attachment description. |
| FailedOperation.InvalidLimit | Reached the query limit (100). |
| FailedOperation.InvalidTemplateID | Invalid template ID or unavailable template. |
| FailedOperation.MissingEmailContent | Missing email content (TemplateData and Simple cannot be both empty). |
| FailedOperation.NoAttachPermission | No permission to send an email with attachments. |
| FailedOperation.NotAuthenticatedSender | Unable to send because the sender is not verified. |
| FailedOperation.NotSupportDate | You cannot query email records for this date. Only data within 90 days can be queried. |
| FailedOperation.ProtocolCheckErr | Incorrect protocol. Make sure the protocol is correct. |
| FailedOperation.ReceiverHasUnsubscribed | The recipient has unsubscribed. |
| FailedOperation.RejectedByRecipients | The message was rejected by the recipient. |
| FailedOperation.SendEmailErr | Email sending error. Please submit a ticket to us for troubleshooting. |
| FailedOperation.ServiceNotAvailable | The request has not taken effect. Try again. |
| FailedOperation.TemplateContentToolarge | The template size is too large. Reduce the size. |
| FailedOperation.TemporaryBlocked | The email has been blocked temporarily due to violations of rules. |
| FailedOperation.TooManyAttachments | Too many attachments. A single email supports up to 10 attachments. |
| FailedOperation.TooManyRecipients | Too many recipients. Set a maximum of 50 recipients at a time. |
| FailedOperation.UnsupportMailType | Unsupported email type. |
| FailedOperation.WithOutPermission | You can only send emails by using a template. |
| FailedOperation.WrongContentJson | The format of the TemplateData field is incorrect. Make sure it is in JSON format. |
| InvalidParameterValue.AttachContentIsWrong | Incorrect attachment content. Make sure the base64 content is correct. |
| InvalidParameterValue.BeginTimeBeforeNow | The start time cannot be earlier than the current time. |
| InvalidParameterValue.CreatedByOther | This sender domain has been created by another Tencent Cloud account. |
| InvalidParameterValue.EmailAddressIsNULL | The recipient or sender address is empty. Please check. |
| InvalidParameterValue.EmailContentIsWrong | Incorrect email content. Make sure TEXT/HTML base64 is correct. |
| InvalidParameterValue.IllegalEmailAddress | Invalid email address. Make sure the address format is correct. |
| InvalidParameterValue.IllegalSenderName | The sender alias is incorrect. |
| InvalidParameterValue.InvalidEmailIdentity | Invalid domain value. |
| InvalidParameterValue.InvalidSmtpPassWord | The password can contain 10-20 characters and must contain at least 2 unique digits, lowercase letters, and uppercase letters. |
| InvalidParameterValue.NoSuchSender | You don’t have the sender address. Check if it exists. |
| InvalidParameterValue.NotExistDomain | This sender domain does not exist. Create it first. |
| InvalidParameterValue.ReceiverDescIllegal | Invalid recipient group description. The description cannot contain special characters and must contain 1 to 300 characters. |
| InvalidParameterValue.ReceiverEmailInvalid | The recipient address is incorrect. |
| InvalidParameterValue.ReceiverNameIllegal | Invalid recipient group name. Check the name and its size. |
| InvalidParameterValue.RepeatCreation | This sender domain already exists. Do not create it again. |
| InvalidParameterValue.RepeatEmailAddress | This email address already exists. Do not create it again. |
| InvalidParameterValue.RepeatReceiverName | Duplicate recipient group name. |
| InvalidParameterValue.SubjectLengthError | The email subject must contain 1 to 100 characters. |
| InvalidParameterValue.TemplateContentIsNULL | The template resource is empty. |
| InvalidParameterValue.TemplateContentIsWrong | Incorrect template content. Make sure the Base64 content is correct. |
| 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. |
| InvalidParameterValue.TemplateNameIllegal | Invalid template name. Make sure the characters and length of the template name are valid. |
| InvalidParameterValue.TemplateNameIsNULL | The template name cannot be empty. |
| InvalidParameterValue.TemplateNotExist | The template does not exist. Please create a template. |
| InvalidParameterValue.TemplateNotMatchData | Template variables do not match recipient list parameters. |
| InvalidParameterValue.WrongDate | Incorrect search date. Make sure the date and its format are valid. |
| LimitExceeded.ExceedReceiverLimit | The number of recipient groups exceeded the limit. |
| 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.CycleParamNecessary | For a recurring sending task, you must select the start time and recurrence. |
| MissingParameter.EmailsNecessary | The recipient email address is required. |
| MissingParameter.ReceiverIdNecessary | The recipient group ID is required. |
| MissingParameter.SendParamNecessary | Sender address, recipient group, and email template are required. |
| MissingParameter.TimedParamNecessary | For a scheduled sending task, you must select the start time. |
| OperationDenied | Operation denied. |
| OperationDenied.DomainNotVerified | Domain verification failed. Check whether the domain has passed verification. |
| OperationDenied.ExceedDomainLimit | The number of sender domains exceeds the upper limit. |
| OperationDenied.ExceedSenderLimit | The number of sender addresses exceeds the upper limit. |
| OperationDenied.ReceiverIsOperating | The recipient group is being uploaded. Try again later. |
| OperationDenied.ReceiverNotExist | The recipient group does not exist. |
| OperationDenied.ReceiverStatusError | The recipient group is empty or hasn’t been completely uploaded. |
| OperationDenied.RepeatPassWord | The password cannot be the same as the last set password. |
| OperationDenied.SendAddressStatusError | The sender address does not exist or hasn’t been approved. |
| OperationDenied.TemplateStatusError | The email template does not exist or hasn’t been approved. |
Yes
No
Was this page helpful?