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.

Code	Status	Definition
1000	`QueuedToSfmcSendService`	The message was added to the Marketing Cloud Engagement message sending service queue.
1500	`QueueFailureToSfmcSendService`	A failure occurred when attempting to add the message sending service queue. You can try to send the message again later.
1501	`ValidationError`	A validation error occurred. You can try to send the message again later.
2000	`DeliveredToAggregator`	The 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.
2500	`FailedToAggregator`	An error occurred when sending the message from Marketing Cloud Engagement to the downstream aggregator. You can try to send the message again later.
2501	`UnknownToAggregator`	The downstream aggregator experienced an error while processing the message.
2502	`FailedToAggregatorDueToInvalidDestinationAddress`	The downstream aggregator couldn’t deliver the message because the destination phone number invalid.
2600	`ThrottledToAggregator`	The 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.
2601	`SocketExceptionToAggregator`	The 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.
3000	`Enroute`	The message is in the process of being delivered to the recipient’s mobile carrier.
3001	`SentToCarrier`	The message was sent to the recipient’s mobile carrier but hasn’t been accepted yet.
3002	`AcceptedByCarrier`	The message was accepted by the recipient’s mobile carrier but hasn’t been delivered yet.
3400	`Unknown`	An unknown error occurred.
4000	`Delivered`	The message was delivered to the recipient’s device.
4500	`Undeliverable`	The message wasn’t delivered to the recipient’s device.
4501	`Expired`	The 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.
4502	`Deleted`	The message wasn’t delivered and has been deleted by the carrier.
4503	`Rejected`	The 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.
4504	`FailedDueToUnknownSubscriber`	The message wasn’t delivered because the carrier couldn’t find the subscriber.
4505	`FailedDueToInvalidDestinationAddress`	The message wasn’t delivered because the destination phone number was invalid.