Toubleshoot SMS Deliveries Faliures

"My message failed to delivery what should I do? "

First, let's check your SMS logs:

1. Navigate to your dashboard (Developer -> SMS -> SMS logs)

2. Search using the recipient's phone number to find specific messages, or look for any sending/delivery failures if you're investigating multiple cases

Once you find your SMS in the logs, here's what different error codes mean and how to fix them:

Opt-out/Unsubscribe Issues (15016, 15010)

* Your recipient has chosen to opt out or unsubscribe from receiving messages

* The fix: Head over to your suppression settings page to review and manage your opt-out list

Receiver Problems (104002)

* You're trying to send messages to a number that can't receive them (like a landline)

* The fix: Update your contact list to remove these numbers and prevent future attempts

Destination/Permission Issues (12003, 15002)

* Your channel doesn't have permission to send messages to this location, usually due to country restrictions

* The fix: Check the regulations for your target country here and if everything looks correct, reach out to support to verify coverage remember to provide them few samples including a timespat a receiving number and the originator (from”) the message was sent

Invalid Numbers (15005)

* The number you're trying to reach isn't active anymore

* The fix: Remove these numbers from your list - even if they become active again, they'll likely belong to different people

Temporary Issues (15006)

* The recipient can't be reached right now (their phone might be off or they're in a no-coverage area)

* The fix: Try sending again later, but avoid multiple immediate attempts

Policy/Rate Limit Issues (15011, 15012, 15015)

* Your messages have been blocked because of your sending patterns or message content

* The fix: Review the policies for your target country here and adjust your approach - you might need to slow down your sending rate or revise your message content

Unknown Errors (15001)

* Sometimes the telecom network doesn't tell us exactly what went wrong

* The fix: Gather several examples and contact our support team - we'll work with the carrier to investigate

For more details information check the full list of failures codes here

Can't find any logs at all?

This means your SMS never made it into our system. Check these places:

* If you sent via API: Look for rejection messages in your API call details

* If you used Flow or Journey: Check those specific logs

* If it was part of a campaign: Review your campaign failure list

How's that? More readable and easier to follow?