SMS Error Codes

While sending messages, CallHub system sends the message to the telecom carrier and the carrier notifies CallHub if the messages were successfully sent, delivered, or failed. Telecom carriers use error codes to identify the reason for the message failure, which can be viewed under the “Error Code” column in the SMS Report. Error codes are described in the table below:

 

ERROR CODE	MESSAGE DELIVERY	DESCRIPTION
30003	Unreachable Destination Handset	The recipient's number is unreachable. The number could be out of service or may not accept messages.
30004	Message blocked	If a message you sent is not delivered to the end device it means the message failed as the destination number is blocked from receiving this message.
30005	Unknown Destination Handset	The destination number is unknown or no longer in service.
30006	Landline or unreachable carrier	The destination number is unable to receive this message. Potential reasons could include trying to reach a landline or, in the case of shortcodes, an unreachable carrier.
30007	Carrier Violation	The number is blocked and the messages are filtered and/or marked as “Spam” for violating carrier regulations.
30008	Unknown Error	The telecom carrier has returned a generic error message. Telecom carriers have no information about this error, it could be that mobile is switched off or not in-network.
50	Invalid destination number	The destination number you entered is either not entered correctly or not SMS-enabled.
300	Failed to dispatch Message	An error occurred while sending the message to carriers. This is an internal failure, and messages with this error code will be retried at a later time.
1000	Unknown error	Delivering your message failed for reasons that are unknown to us and to our carriers.
70	Destination permanently unavailable	The destination phone number is not active and there is no indication of when it will become available again
90	No route available	The carrier and fallback carriers were not able to deliver the SMS message because the route was not available.
200	Source number blocked by STOP from destination number	The destination has opted out from your campaign and blocked all messages sent from your phone number. Opt-outs are typically received via text message replies with an opt-out keyword including “STOP”
20	Network Error	The carrier delivering the text message had network issues. This is a temporary error. You can retry at a later time when the carrier network is unaffected.
30	Spam Detected	The error occurs when the messages you are trying to send are filtered by the carrier when Spam is detected by the carrier.

The above error codes will help you to identify and understand the cause of the message failures for your campaign. If you encounter an error code that is not included in the list mentioned above, let us know in the comments or send us an email to [email protected].