Please note this list does not include all errors as there are hundreds of them across the main carriers. This list encompasses the ones we see the most common that have underlying solutions. Most errors are at the carrier level and aren't something that can be remedied by changing a message or a setting we have access to.
Number registration (TCR) errors
Error Code | Error Message | Common Cause | Solution |
4773 | Inactive-campaign | Every phone number needs an active carrier registration (TCR) before messages can send. Sometimes the registration becomes disconnected from the phone number and needs to be reassigned. | Open a support chat with Ikeono so we can check your number's registration. |
30034 | Message not sent due to inactive campaign | Usually happens on new accounts when the carrier registration (TCR) wasn't fully assigned to the phone number. | Open a support chat with Ikeono and we'll fix your number's registration. |
Carrier-Related Errors
Error Code | Error Message | Common Cause | Solution |
30007 | Message filtered | Your message was identified as spam or unwanted messaging by Twilio's message filtering system. | Review your message for prohibited content (profanity, mentions of THC, CBD, firearms, or adult content). Remove any flagged terms and try sending the message again. |
4410 | Could-not-download-media | Some files are too large to meet carrier MMS limits and may be rejected. | Ikeono compresses media automatically, but for higher resolution, use email or a Drive link instead. |
4770 | Destination-spam-detected | Most often this is a false positive flag on a receiving carrier's spam filters, and is often caused by URLs but can also be from special characters. | If there's a URL in the message, send the text first, wait a few seconds, then send the URL as its own message. |
4771 | Rejected-shortened-url | Carriers block public link shorteners like Bit.ly and TinyURL due to scam associations. | Send the full link instead of a link from a public shortener like Bit.ly. Links Ikeono shortens automatically (they start with u.ikeono.com) are fine to send. |
Recipient Device or Number Issues
Error Code | Error Message | Common Cause | Solution |
4750 | Destination-rejected-message | The carrier rejected the message without a clear reason. For AT&T, it could be a prepaid user, blocked SMS type, or spam flag. | If the number is one you have messaged before, you can try messaging again later. |
4720 | Invalid-destination-address | This usually happens when texting a landline. For T-Mobile, it may mean the user blocks toll-free or short code messages. | This number can’t receive texts. We recommend reaching out to the customer through another channel. |
4700 | Invalid-service-type | Most often this error occurs when texting a landline. | This number can’t receive texts. We recommend reaching out to the customer through another channel. |
30003 | Unreachable destination handset | Device is off, out of service, or unreachable. Check device power, signal, and carrier network. | Try again later or use another contact method. |
30005 | Unknown destination handset | Number is not valid or not in service. | Confirm the number is correct and active. |
30006 | Landline or unreachable carrier | Number is a landline or carrier does not support SMS. Verify number type and carrier support. | This number can’t receive texts. We recommend reaching out to the customer through another channel. |
4753 | Destination-rejected-handset | The receiving carrier couldn't deliver the message to the customer's phone. The customer may have an unpaid phone bill, be out of the country without service, or it may be a temporary carrier error. | This can't be fixed from Ikeono's side. Wait a few hours and try sending again, or reach out to the customer through another channel. |
4721 | TN on deactivation list | The receiving carrier couldn't deliver the message to the customer's phone. The customer may have an unpaid phone bill, be out of the country without service, or it may be a temporary carrier error. | This can't be fixed from Ikeono's side. Wait a few hours and try sending again, or reach out to the customer through another channel. |
Other
Error Code | Error Message | Common Cause | Solution |
4405 | Rejected-unallocated-from-number | Your number is no longer hosted for messaging with Ikeono. This most often happens when the phone number is ported to a new carrier. | Open a support chat with Ikeono to rehost the phone number. |
Message Retries
For certain errors, carriers will queue and retry sending a text for up to 10 hours. If the receiving carrier doesn't accept or deliver the message in that time, it shows as failed in the Ikeono portal.
