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. |