To further enhance error diagnosis capabilities and improve the integration experience for Global SMS, Tencent Cloud SMS will gradually roll out a new set of standard delivery receipt error codes starting December 1, 2026. At the same time, new fields—sub-error code and corresponding error description—will be added to API responses.
Details are as follows:
1. Changes
1.1 Launch of new standard delivery receipt error codes for Global SMS
The new error-code system provides a more granular and standardized classification of failure causes, helping you identify the reasons for message delivery failures more accurately. For details, please refer to the updated Global SMS Delivery Receipt Error Codes documentation . 1.2 New fields added to API output parameters
● Sub-error code: string, optional, field name: sub_error
● Sub-error description: string, optional, field name: sub_error_desc
● Sub-error code: string, optional, field name: SubError
● Sub-error description: string, optional, field name: SubErrorDesc
● Sub-error code: string, optional, field name: SubError
● Sub-error description: string, optional, field name: SubErrorDesc
2. Important Notes
2.1 Please evaluate compatibility with the newly added fields
The new fields are added in a backward-compatible manner and will not affect existing fields. However, if your system enforces strict validation on API responses (e.g., rejecting unknown fields or using strict deserialization), please adapt in advance to avoid parsing exceptions.
2.2 Please promptly update business logic mappings based on delivery receipt error codes
If you currently implement business decisions, retries, or alerting logic based on delivery receipt error codes, please update your error-code mapping according to the latest Global SMS Delivery Receipt Error Codes documentation to ensure your business logic remains consistent with the new error codes.