Messaging Failure Reasons
As messages get sent on to the carriers, there are cases where they will return a FAILED message status. Carriers are now consistently providing more detailed failure reasons in conjunction with the failed message status. As a result, we have updated our platform to capture these reasons in plain language and store them. This allows us to surface the failure reasons (when provided) in our Account & Line Detail reports alongside the message status.
NOTE: Not every single failed message may have a detailed failure reason.
Failure Reason Code | Summary |
---|---|
1 - CarrierException | The carrier provided a generic error code. |
2 - MalformedSource | The source number is incorrectly formatted. |
3 - InvalidSource | The source number does not exist (in the carrier), etc. |
4 - MalformedDestination | The destination number is incorrectly formatted. |
5 - InvalidDestination | The destination number does not exist, does not have SMS, etc. |
6 - CarrierOptOut | The recipient is opted out from the carrier or service provider. |
7 - CarrierRejected | The carrier or service provider rejected the message. |
8 - CarrierTimeout | The carrier or service provider experienced extreme traffic or a timeout. |
9 - CarrierRateLimited | The carrier or service provider rate limit has been reached. |
10 - CarrierRoutingError | The carrier or service provider could not route to the destination. |
11 - CarrierAccountError | The carrier account has an issue, the incorrect external credentials are being used, etc. |
12 - FlaggedAsSpam | The carrier or service provider flagged the message as spam. |
13 - ForbiddenCountry | The carrier or service provider marked the destination country as forbidden. |
14 - ForbiddenShortCode | An invalid or non-existent short code is being used as the source. |
15 - MediaUnavailable | Attached media could not be found or retrieved. |
16 - CarrierContentSizeExceeded | Attached media or message body exceeds the carrier content size limit. |
17 - InvalidContentType | Attached media is an invalid content type. |
18 - UnknownServiceCenterAddress | The service center address is unknown. |