tencent cloud

邮件推送

动态与公告
产品动态
关于新增独立 IP 增值服务的公告
产品简介
产品概述
产品功能
产品优势
应用场景
规格明细
购买指南
价格说明
快速入门
邮件配置
邮件发送
信誉度等级说明
控制台指南
邮件配置
邮件发送
数据统计
投递回应
API 文档
History
Introduction
API Category
调用方式
域名验证相关接口
邮件相关接口
模板相关接口
统计相关接口
发信地址相关接口
黑名单相关接口
查询发送状态相关接口
批量任务相关接口
自定义黑名单相关接口
Data Types
Error Codes
SMTP 文档
SMTP 发送邮件指南
SMTP 服务地址
Java 调用示例
Go 调用示例
PHP 调用示例
Python 调用示例
C# 调用示例
发送带附件的邮件
错误码
Webhook 文档
邮件通知事件
发件限制
附件类型
常见问题
入门相关问题
计费相关问题
发送限制相关问题
发送功能相关问题
域名相关问题
模板相关问题
身份验证和配置相关问题
独立 IP 相关问题
递送相关问题
API 使用相关问题
回调相关问题
垃圾箱相关问题
安全性相关问题
域名加速配置相关问题
注意事项
其他问题
联系我们

Error Codes

PDF
聚焦模式
字号
最后更新时间: 2026-02-27 14:28:45

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.FileURLNotExist URL is unavailable or not found.
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.IllegalURL Mail contains non-compliant link.
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. please check whether the attachment name contains special characters. for details, see the appendix attachment description (https://www.tencentcloud.comom/document/product/1288/51951?from_cn_redirect=1).
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 push platform will suspend sending emails to the service provider for 10 minutes due to the corresponding recipient service provider's limit. it will be automatically released after 10 minutes.
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.URLForbidden Forbid users with low delivery rate to include URL webpage links in email content.
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.
InternalError.QueryDataBaseFailed Query database timeout or fail.
InvalidParameter.AppIdIsRequired AppId does not exist.
InvalidParameter.InvalidEndTimeFormat End time format error.
InvalidParameter.InvalidStartTimeFormat Start time format error.
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.InValidTemplateData The template parameter attached to the recipient address cannot contain html tags.
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.TemplateDataLenLimit The template parameter (entire JSON structure) attached to a single recipient address exceeds the length limit of 800 bytes.
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.NotAllowDelete Domain name cannot be deleted.
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.SenderWithDomainIsNotEmpty The sender address related to that domain name is not empty.
OperationDenied.TemplateStatusError The email template does not exist or hasn’t been approved.

帮助和支持

本页内容是否解决了您的问题?

填写满意度调查问卷,共创更好文档体验。

文档反馈