Skip to main content

Common Error Codes and how to fix them

If your customer didn't receive a text, it shows as failed in the Ikeono portal with an error code. Find the code below to see why and what to do. If your customer's phone is off or out of service, the fix is usually to wait a few hours and try again.

Written by Brett Lang

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.

Did this answer your question?