Error Code | Description |
InternalError.SigVerificationFail | Backend check of Sig failed. |
FailedOperation.ContainSensitiveWord | |
InternalError.SigFieldMissing | The request packet in the backend packet does not contain the Sig field or the Sig field is empty. |
FailedOperation.FailResolvePacket | Failed to parse the request packet. This is usually caused by noncompliance with the API interface specifications. See Detailed Analysis of Error 1004 in Request Packet Parsing. |
UnauthorizedOperation.RequestPermissionDeny | |
InternalError.OtherError | |
InternalError.Timeout | |
UnauthorizedOperation.RequestIpNotInWhitelist | The request IP address is not in the allowlist. You have configured verification of the request source IP address, but the current request IP address is detected as not in the configured list. If needed, contact SMS Helper. |
InternalError.RestApiInterfaceNotExist | The RESTful API does not exist. Check the RESTful API documentation. |
FailedOperation.SignatureIncorrectOrUnapproved | The signature is not approved or its format is incorrect. (1) Log in to the SMS console and check whether the signature has been approved. (2) Check whether the signature complies with format specifications. A signature can contain only Chinese characters, English letters, and digits, and must be 2 to 12 characters in length. If you have any questions, contact SMS Helper. |
LimitExceeded.DeliveryFrequencyLimit | The SMS sending hit the frequency limit policy. You can adjust the SMS frequency limit policy in the console. If you have other requirements, contact SMS Helper. |
FailedOperation.TemplateIncorrectOrUnapproved | The template is not approved or the content does not match the approved template. (1) Log in to the SMS console and check whether the template has been approved. (2) Click here to check whether the template format is correct. If you have any questions, contact SMS Helper. |
FailedOperation.PhoneNumberInBlacklist | The mobile number is in the do-not-disturb list or the unsubscribe list. This is usually caused by user unsubscription or by matching a carrier list. To resolve this, contact SMS Helper. |
InvalidParameterValue.IncorrectPhoneNumber | The mobile number format is incorrect. |
InvalidParameterValue.ContentLengthLimit | The requested SMS content is too long. For SMS length calculation rules, see SMS Length Calculation Rules. |
InvalidParameterValue.SdkAppIdNotExist | SdkAppId does not exist. Check whether the SdkAppId belongs to this account. |
UnauthorizedOperation.SdkAppIdIsDisabled | |
InternalError.RequestTimeException | The request initiation time is abnormal. This is usually caused by a difference of more than 10 minutes between your server time and the Tencent Cloud CVM time. Check whether the server time and the time field in the API are normal. |
LimitExceeded.AppDailyLimit | The daily number of sent business SMS messages exceeds the configured upper limit. You can adjust the SMS frequency limit policy in the console. |
LimitExceeded.PhoneNumberThirtySecondLimit | The number of SMS messages sent to a single mobile number within 30 seconds exceeds the configured upper limit. You can adjust the SMS frequency limit policy in the console. |
LimitExceeded.PhoneNumberOneHourLimit | The number of SMS messages sent to a single mobile number within 1 hour exceeds the configured upper limit. You can adjust the SMS frequency limit policy in the console. |
LimitExceeded.PhoneNumberDailyLimit | The daily number of SMS messages sent to a single mobile number exceeds the configured upper limit. You can adjust the SMS frequency limit policy in the console. |
LimitExceeded.PhoneNumberSameContentDailyLimit | The number of identical SMS messages sent to a single mobile number exceeds the configured upper limit. You can adjust the SMS frequency limit policy in the console. |
FailedOperation.MarketingSendTimeConstraint | Marketing SMS sending time limit: To avoid disturbing users, marketing SMS can only be sent between 8:00 and 22:00. |
UnsupportedOperation | The operation is not supported. |
FailedOperation.InsufficientBalanceInSmsPackage | |
UnauthorizedOperation.IndividualUserMarketingSmsPermissionDeny | |
UnauthorizedOperation.ServiceSuspendDueToArrears | The service is suspended due to overdue payment. You can log in to Tencent Cloud to top up and settle the overdue payment. |
UnsupportedOperation.ContainDomesticAndInternationalPhoneNumber | The bulk sending request contains both Chinese mainland numbers and international numbers. Check the following: (1) Whether a Chinese mainland signature or template is used to send SMS messages to international numbers. (2) Whether an international signature or template is used to send SMS messages to Chinese mainland numbers. |
InvalidParameterValue.TemplateParameterLengthLimit | A single template variable exceeds 12 characters. Enterprise users have no limit on variable characters. You can change the account identity type to enterprise by following the instructions here. The change takes effect about one hour later. |
InvalidParameterValue.TemplateParameterFormatError | The parameter format of the verification code template is incorrect. For a verification code template, only 0–6 digits can be passed in as the template variable. |
UnsupportedOperation.UnsupportedRegion | SMS sending is not supported in this region. |
LimitExceeded.PhoneNumberCountLimit | The number of mobile numbers submitted in a single API call exceeds 200. Follow the description of the PhoneNumberSet input parameter in the API documentation. |
LimitExceeded.DailyLimit | The number of SMS messages delivered on the current day exceeds the set upper limit (for Global SMS). If you want to adjust the limit, you can contact SMS Helper for assistance. |
InvalidParameterValue.ProhibitedUseUrlInTemplateParameter | Using URLs in template variables is prohibited. |
LimitExceeded.AppMainlandChinaDailyLimit | The number of Chinese Mainland SMS messages sent per day has exceeded the preset limit. You can adjust the message sending threshold in Application Management > Basic Configuration in the SMS console. |
LimitExceeded.AppGlobalDailyLimit | The number of Global SMS messages sent per day has exceeded the preset limit. You can adjust the message sending threshold in Application Management > Basic Configuration in the SMS console. |
LimitExceeded.AppCountryOrRegionInBlacklist | The Global SMS message failed to be sent because the recipient country/region is not included in the specified country/region list. You can adjust the country/region list in Application Management > Basic Configuration in the SMS console. |
LimitExceeded.AppCountryOrRegionDailyLimit | The number of Global SMS messages sent to the specified country/region per day has exceeded the preset limit. You can adjust the message sending limit in Application Management > Basic Configuration in the SMS console. |
UnsupportedOperation.ChineseMainlandTemplateToGlobalPhone | A Chinese Mainland SMS template cannot be used to sent messages to global numbers. Please use a Global SMS template instead. |
UnsupportedOperation.GlobalTemplateToChineseMainlandPhone | A Global SMS template cannot be used to sent messages to Chinese mainland numbers. Please use a Chinese Mainland SMS template instead. |
FailedOperation.TemplateUnapprovedOrNotExist | The template is not approved or does not exist. Log in to the SMS console and check whether the template has been approved. If you have any questions, contact SMS Helper. |
FailedOperation.TemplateParamSetNotMatchApprovedTemplate | The request content does not match the approved template content. Check whether the number of template parameters in the request is consistent with the applied template. If you have any questions, contact SMS Helper. |
LimitExceeded.GlobalSmsSendingRateLimit | The Global SMS sending rate has reached the configured limit. If you have any questions, contact SMS Helper for assistance. |
InternalError.UnknownError | Unknown error type. |
Error Code | Description | Handling Measures |
1001 | sig verification failed. | Check the API sig format description. |
1002 | The SMS content contains sensitive words. | |
1003 | The request packet does not contain the sig field or the sig field is empty. | Follow the API interface specifications. |
1004 | Failed to parse the request packet. This is usually caused by noncompliance with the API specifications. | |
1006 | The request has no permission. | Check the error message description. If the issue persists, contact SMS Helper and provide the failed mobile number. |
1007 | Other errors. | Check the error message description. If the issue persists, contact SMS Helper and provide the failed mobile number. |
1008 | SMS sending request timed out. | This error occurs rarely. Retry to resolve the issue. |
1009 | The request IP address is not in the allowlist. | You have configured verification of the request source IP address, but the current request IP address is detected as not in the configured list. If needed, contact SMS Helper. |
1011 | The REST API does not exist. | Check the REST API documentation. |
1012 | The signature format is incorrect or the signature is not approved. | A signature can contain only Chinese characters, English letters, and digits, and must be 2 to 12 characters in length. If the signature complies with format specifications, check whether it has been approved. |
1013 | The SMS sending hit the frequency limit policy. | You can adjust the SMS frequency limit policy in the console. If you have other requirements, contact SMS Helper. |
1014 | The template is not approved or the requested content does not match the approved template content. | |
1015 | The mobile number is in the do-not-disturb list or the unsubscribe list. This is usually caused by user unsubscription or by matching a carrier list. | |
1016 | The mobile number format is incorrect. | |
1017 | The requested SMS content is too long. | |
1019 | sdkappid does not exist. | - |
1020 | sdkappid is disabled. | |
1021 | The request initiation time is abnormal. This is usually caused by a difference of more than 10 minutes between your server time and the Tencent Cloud CVM time. | Check whether the server time and the time field in the API are normal. |
1022 | The daily number of sent business SMS messages exceeds the configured upper limit. | You can adjust the SMS frequency limit policy in the console. |
1023 | The number of SMS messages sent to a single mobile number within 30 seconds exceeds the configured upper limit. | You can adjust the SMS frequency limit policy in the console. |
1024 | The number of SMS messages sent to a single mobile number within 1 hour exceeds the configured upper limit. | You can adjust the SMS frequency limit policy in the console. |
1025 | The daily number of SMS messages sent to a single mobile number exceeds the configured upper limit. | You can adjust the SMS frequency limit policy in the console. |
1026 | The number of identical messages sent to a single mobile number exceeds the configured upper limit. | You can adjust the SMS frequency limit policy in the console. |
1029 | Marketing SMS sending time limit | To avoid disturbing users, marketing SMS can only be sent between 8:00 and 22:00. |
1030 | The request is not supported. | - |
1031 | Insufficient package balance | |
1032 | Individual users do not have permission to send marketing SMS. | |
1033 | Service suspended due to overdue payment | You can log in to Tencent Cloud to top up and settle the overdue payment. |
1034 | The group SMS request contains both Chinese mainland and global mobile numbers. | Send SMS messages to Chinese mainland and global mobile numbers separately. |
1036 | A single template variable exceeds 12 characters. | Enterprise users have no limit on variable characters. You can change the account identity type to enterprise by following the identity change guide. The change takes effect about one hour later. |
1038 | For a verification code template, only 0–6 digits can be passed in as the template variable. | - |
1045 | SMS sending is not supported in this region. | - |
1046 | The number of mobile numbers submitted in a single bulk sending API call exceeds 200. | Follow the API interface specifications. |
1047 | The number of global SMS messages that can be sent per day is limited. | |
1048 | Using URLs in template variables is prohibited. | - |
1049 | The daily number of Chinese mainland SMS messages sent exceeds the configured upper limit. | You can adjust the SMS sending frequency limit policy in the console. |
1050 | The number of global SMS messages sent on the current day exceeds the set upper limit. | You can adjust the SMS sending frequency limit policy in the console. |
1051 | The target country/region for SMS sending is in the blocklist. | You can adjust the SMS sending restriction policy in the console. |
1052 | The daily number of SMS messages sent to the recipient country/region exceeds the configured upper limit. | You can adjust the SMS sending frequency limit policy in the console. |
1053 | Chinese mainland SMS templates cannot be used to send SMS messages to international numbers. | Use a Global SMS template to send messages to global numbers. |
1054 | A Global SMS template cannot be used to send messages to Chinese mainland numbers. | To send SMS messages to Chinese mainland numbers, use the Chinese mainland SMS template. |
1055 | The template is not approved or does not exist. | |
1056 | The requested content does not match the approved template content. | Check whether the number of template parameters in the request is consistent with the applied template. |
1057 | The Global SMS sending rate has reached the configured limit. | |
60008 | Request processing timed out. |
Note:The new standardized Global SMS delivery status error codes listed below will take effect in phases from December 1, 2026.
Category | Delivery Status | Sub-error Code | Description |
Delivered | DELIVRD | 000 | The message was delivered successfully. |
| | 001 | The message was delivered successfully. |
| | 002 | The message was delivered successfully. |
| | 003 | The message was delivered successfully. |
Undelivered | UNDELIV | 101 | This phone number has exceeded the daily SMS receiving limit set by carriers. Please try again tomorrow. |
| | 102 | The sending frequency for this SMS content exceeds the limits set by carriers. Please reduce the sending frequency. |
| | 103 | Carriers have blocked this SMS content because it has been sent too many times. Please send the same content less frequently. |
| | 104 | The Sender ID is not registered in the destination country or region. Please register it before sending. |
| | 105 | This Sender ID is blocked on the recipient's phone. Please ask the recipient to unblock it. |
| | 106 | Carriers have blocked this SMS because its content is non-compliant or has not been whitelisted. Please check the content or contact the Tencent Cloud SMS team for whitelisting. |
| | 107 | Carriers have blocked this SMS because its content has not been whitelisted. Please contact the Tencent Cloud SMS team for whitelisting. |
| | 108 | The recipient's phone is switched off or outside the service area. |
| | 109 | This phone number does not exist. |
| | 110 | Service for this phone number has been suspended. The number cannot receive SMS. |
| | 111 | The recipient's SMS inbox is full and cannot receive new messages. Please ask the recipient to clear the inbox. |
| | 112 | Carriers have not activated this number range. Please verify that the phone number is correct. |
| | 113 | Roaming is disabled on the recipient's phone. Please ask the recipient to enable roaming, then try again. |
| | 114 | This number has an abnormal service status. Please check if it was recently ported to another network. SMS can be received normally only after porting is complete and system records are updated. |
| | 115 | This phone number does not support receiving SMS (for example, a landline number). |
| | 116 | Invalid phone number. Please check whether it has active mobile service. |
| | 117 | The phone number is temporarily unreachable due to a signal issue. Please try again later. |
| | 118 | The phone number is temporarily unreachable due to a signal issue. Please try again later. |
| | 119 | The phone number is temporarily unreachable due to a signal issue. Please try again later. |
| | 120 | This phone number could not be located. Please verify that it is valid. |
Expired | EXPIRED | 201 | Delivery timed out. Please check the phone number's service status or try again later. |
| | 202 | Delivery timed out. Please check the phone number's service status or try again later. |
| | 203 | Delivery timed out. Please check the phone number's service status or try again later. |
| | 204 | Carriers are experiencing network congestion. Please try again later. |
| | 205 | Carriers are experiencing network issues. Please try again later. |
Deleted | DELETED | 301 | Carriers have blocked the SMS. Please check the SMS content for compliance or contact the Tencent Cloud SMS team for detailed clarification. |
| | 302 | Carriers have blocked the SMS. Please check the SMS content for compliance or contact the Tencent Cloud SMS team for detailed clarification. |
| | 303 | Carriers have blocked the SMS. Please check the SMS content for compliance or contact the Tencent Cloud SMS team for detailed clarification. |
| | 304 | Carriers have blocked this Sender ID because its sending frequency is too high. Please reduce the sending frequency. |
| | 305 | Carriers have blocked the SMS. Please check the SMS content for compliance or contact the Tencent Cloud SMS team for detailed clarification. |
| | 306 | The SMS could not be delivered because its format is invalid. Please check the SMS format or contact the Tencent Cloud SMS team for detailed clarification. |
Rejected | REJECTD | 401 | The Sender ID format does not meet the requirements of the destination country or region. Please correct it and resend. |
| | 402 | Carriers have blacklisted this Sender ID. Please resubmit the registration documents. |
| | 403 | Carriers have blocked this Sender ID. Please resubmit the registration documents. |
| | 404 | This Sender ID type is not supported in the destination country or region. Please use a supported type and resend. |
| | 405 | The SMS was blocked because its content contains sensitive words. Please check the content for compliance. |
| | 406 | The SMS content format is not supported. Please modify it and resend. |
| | 407 | The SMS type does not match the sending channel type. Please fix the mismatch and try again. |
| | 408 | The SMS content exceeds the length limits set by carriers. Please shorten the content. |
| | 409 | The SMS was blocked because its content contains sensitive words. Please check the content for compliance. |
| | 410 | Carriers have blocked the SMS because its content has not been whitelisted. Please contact the Tencent Cloud SMS team for whitelisting, then try again. |
| | 411 | Do Not Disturb (DND) is enabled for this phone number. The number cannot receive SMS. |
| | 412 | This phone number is on the anti-spam protection lists maintained by carriers and cannot receive SMS. |
| | 413 | Sending marketing SMS is not permitted at this time. Please adjust the sending time. |
| | 414 | Carriers have flagged this phone number for suspected SMS spam and blocked it. |
| | 415 | Carriers have blacklisted this phone number, so it cannot receive SMS. |
| | 416 | The message was not delivered. Please try again later. |
Unknown | UNKNOWN | 501 | Unknown error. The carriers have not provided specific failure reasons. Please contact the Tencent Cloud SMS team for detailed clarification. |
| | 502 | Unknown error. The carriers have not provided specific failure reasons. Please contact the Tencent Cloud SMS team for detailed clarification. |
| | 503 | Unknown error. The carriers have not provided specific failure reasons. Please contact the Tencent Cloud SMS team for detailed clarification. |
| | 504 | Unknown error. The carriers have not provided specific failure reasons. Please contact the Tencent Cloud SMS team for detailed clarification. |
| | 505 | An issue with the carriers' systems prevented SMS delivery. |
| | 506 | Carriers are experiencing a connection issue. The SMS was not delivered. |
| | 507 | Unknown error. The carriers have not provided specific failure reasons. Please contact the Tencent Cloud SMS team for detailed clarification. |
| | 508 | Unknown error. The carriers have not provided specific failure reasons. Please contact the Tencent Cloud SMS team for detailed clarification. |
| | 509 | This SMS type is not supported in the destination country or region and cannot be delivered. |
| | 510 | Unknown error. The carriers have not provided specific failure reasons. Please contact the Tencent Cloud SMS team for detailed clarification. |
| | 511 | Unknown error. The carriers have not provided specific failure reasons. Please contact the Tencent Cloud SMS team for detailed clarification. |
| | 512 | Unknown error. The carriers have not provided specific failure reasons. Please contact the Tencent Cloud SMS team for detailed clarification. |
| | 513 | Unknown error. The carriers have not provided specific failure reasons. Please contact the Tencent Cloud SMS team for detailed clarification. |
| | 514 | Unknown error. The carriers have not provided specific failure reasons. Please contact the Tencent Cloud SMS team for detailed clarification. |
| | 515 | Unknown error. The carriers have not provided specific failure reasons. Please contact the Tencent Cloud SMS team for detailed clarification. |
| | 516 | Unknown error. The carriers have not provided specific failure reasons. Please contact the Tencent Cloud SMS team for detailed clarification. |
| | 517 | Unknown error. The carriers have not provided specific failure reasons. Please contact the Tencent Cloud SMS team for detailed clarification. |
| | 518 | Unknown error. The carriers have not provided specific failure reasons. Please contact the Tencent Cloud SMS team for detailed clarification. |
| | 519 | Unknown error. The carriers have not provided specific failure reasons. Please contact the Tencent Cloud SMS team for detailed clarification. |
| | 520 | Unknown error. The carriers have not provided specific failure reasons. Please contact the Tencent Cloud SMS team for detailed clarification. |
| | 521 | Unknown error. The carriers have not provided specific failure reasons. Please contact the Tencent Cloud SMS team for detailed clarification. |
| | 522 | Unknown error. The carriers have not provided specific failure reasons. Please contact the Tencent Cloud SMS team for detailed clarification. |
| | 523 | Unknown error. The carriers have not provided specific failure reasons. Please contact the Tencent Cloud SMS team for detailed clarification. |
| | 524 | Unknown error. The carriers have not provided specific failure reasons. Please contact the Tencent Cloud SMS team for detailed clarification. |
| | 525 | Unknown error. The carriers have not provided specific failure reasons. Please contact the Tencent Cloud SMS team for detailed clarification. |
Apakah halaman ini membantu?
Anda juga dapat Menghubungi Penjualan atau Mengirimkan Tiket untuk meminta bantuan.
masukan