SMS Status Codes

This table includes status codes returned from MobileConnect API calls for all locations. Use these codes to evaluate and troubleshoot your SMS sends.

CodeStatusDefinition
1000QueuedToSfmcSendServiceThe message was added to the Marketing Cloud Engagement message sending service queue.
1500QueueFailureToSfmcSendServiceA failure occurred when attempting to add the message sending service queue. You can try to send the message again later.
1501ValidationErrorA validation error occurred. You can try to send the message again later.
2000DeliveredToAggregatorThe message was delivered from Marketing Cloud Engagement to a downstream delivery partner (aggregator). This status doesn’t necessarily indicate that the message was delivered to the recipient. The status is updated when we receive a delivery confirmation from the mobile carrier or device. For shared codes, this status is the final one.
2500FailedToAggregatorAn error occurred when sending the message from Marketing Cloud Engagement to the downstream aggregator. You can try to send the message again later.
2501UnknownToAggregatorThe downstream aggregator experienced an error while processing the message.
2502FailedToAggregatorDueToInvalidDestinationAddressThe downstream aggregator couldn’t deliver the message because the destination phone number invalid.
2600ThrottledToAggregatorThe downstream aggregator couldn’t accept the message because too many requests were received simultaneously. Marketing Cloud Engagement automatically attempts to re-send messages that were throttled in this way. If you see this status in your logs, it means that our attempts to re-send the message were unsuccessful.
2601SocketExceptionToAggregatorThe downstream aggregator couldn’t accept the message because of a connection error. Marketing Cloud Engagement automatically attempts to re-send messages that fail in this way. If you see this status in your logs, it means that our attempts to re-send the message were unsuccessful.
3000EnrouteThe message is in the process of being delivered to the recipient’s mobile carrier.
3001SentToCarrierThe message was sent to the recipient’s mobile carrier but hasn’t been accepted yet.
3002AcceptedByCarrierThe message was accepted by the recipient’s mobile carrier but hasn’t been delivered yet.
3400UnknownAn unknown error occurred.
4000DeliveredThe message was delivered to the recipient’s device.
4500UndeliverableThe message wasn’t delivered to the recipient’s device.
4501ExpiredThe message wasn’t delivered and has exceeded the maximum delivery time. This issue can occur when the recipient’s device isn’t connected to a mobile network or is otherwise unreachable.
4502DeletedThe message wasn’t delivered and has been deleted by the carrier.
4503RejectedThe message was rejected by the recipient’s mobile carrier. This issue can occur when the carrier determines that the message is spam or other abusive content.
4504FailedDueToUnknownSubscriberThe message wasn’t delivered because the carrier couldn’t find the subscriber.
4505FailedDueToInvalidDestinationAddressThe message wasn’t delivered because the destination phone number was invalid.