.png){kind=logo}
Common SMS/MMS Error Messages
30001 – Queue Overflow
The carrier’s message queue was full, so delivery failed. Try resending after a few minutes. If this happens often, send in smaller batches or spread messages out to avoid queue congestion.
30002 – Account Suspended
Delivery failed because the sending account is suspended. Contact support to review account status and restore delivery before resending.
30003 – Unreachable Destination Handset
The recipient’s phone could not be reached. It may be turned off, disconnected, or out of service. Try sending again later once the handset is available.
30004 – Message Blocked
The carrier or recipient blocked the message. This can happen due to local rules or settings. Confirm with the recipient and resend once any blocks are cleared.
30005 – Unknown Destination Handset
The number is invalid or not registered with a mobile network. Confirm the number is correct and active, then resend.
30006 – Landline or Unreachable Carrier
The recipient’s number cannot accept SMS, often because it is a landline. Use a phone call instead or request a mobile number that supports texting.
30007 – Message Filtered
The carrier filtered the message as spam or disallowed content. Simplify the wording, remove links or emojis, and resend.
30008 – Unknown Error
The carrier returned an unspecified error. Try resending. If the issue repeats, provide the error and timestamp to support.
30009 – Missing Inbound Segment
Part of a multi-part message did not arrive. Shorten the content or split into smaller messages, then resend to ensure full delivery.
30010 – Message Price Exceeds Max Price
Delivery cost was higher than the allowed maximum price. Review and adjust your messaging price threshold, then resend.
30011 – MMS Not Supported
The recipient’s number or region does not support MMS. Resend the content as plain SMS without media.
30012 – TTL Too Small
The message’s “time to live” setting was too short to allow delivery. Increase the TTL and resend.
30013 – TTL Too Large
The TTL was set higher than allowed. Reduce TTL to within carrier limits and resend.
30014 – Invalid ‘To’ Attributes
The recipient number or “To” attributes were invalid. Confirm the format and required fields, correct them, then resend.
30015 – Unsupported Channel Type
The chosen channel is not supported for this number. Resend using a supported type, such as plain SMS.
30016 – Incompatible ‘To’ and ‘From’ Channel Types
The sender and recipient channels are not compatible (for example, MMS to a number that only supports SMS). Adjust and resend using a valid channel.
30017 – Carrier Network Congestion
Delivery failed due to temporary carrier congestion. Wait and resend later. If repeated, schedule sends during less busy hours.
30018 – Sender ID Pre-Registration Required
The destination carrier requires a pre-registered sender ID. Register the sender ID with the carrier, then resend.
30019 – Content Size Exceeds Carrier Limit
The message body or media was too large. Shorten the text or reduce file size, then resend in smaller parts.
30020 – Message Scheduling Failure
Delivery failed due to an internal scheduling error. Resend the message immediately. If it repeats, contact support.
30021 – Messaging Service Orchestration Failure
An internal error occurred with the messaging service. Retry sending. If it fails again, escalate with support.
30022 – US A2P 10DLC Rate Limit Exceeded
Messages exceeded the allowed sending rate under A2P 10DLC. Reduce the sending rate and wait until limits reset before resending.
30023 – US A2P 10DLC Daily Cap Reached
The daily limit for messages has been reached. Wait until the next day or adjust sending campaigns.
30024 – Numeric Sender ID Not Provisioned
The numeric sender ID has not been provisioned with the carrier. Provision it properly or resend from a verified number.
30025 – T-Mobile Daily Limit 50% Consumed
Half the daily T-Mobile A2P 10DLC limit has been used. Monitor usage to avoid hitting the cap.
30026 – T-Mobile Daily Limit 70% Consumed
Seventy percent of the daily T-Mobile limit is used. Slow down sending or schedule messages for later.
30027 – T-Mobile Daily Limit Reached
The daily T-Mobile limit has been fully reached. Stop sending to T-Mobile until the next day.
30028 – Invalid API Version
The API version in the request was invalid. Correct the API version and resend.
30029 – Invalid Content Retention Setting
The content retention value provided was invalid. Correct the setting and resend.
30030 – Invalid Address Retention Setting
The address retention parameter was invalid. Fix the setting and resend.
30031 – Invalid MaxRate
The MaxRate (message rate limit) setting was invalid. Adjust to a valid rate and resend.
30032 – Toll-Free Number Not Verified
The toll-free number has not completed verification. Verify the number through Twilio, then retry sending.
30033 – US A2P 10DLC Campaign Suspended
The registered campaign is suspended. Resolve campaign compliance issues before resending.
30034 – Message from Unregistered Number
The sending number is not registered for A2P 10DLC. Register the number, then resend.
30035 – Message from Number Still Configuring
The sending number is still in setup. Wait for configuration to complete, then resend.
30036 – Validity Period Expired
The message expired before it could be delivered. Send messages closer to their intended delivery time.
30037 – Outbound Messaging Disabled
Outbound messaging is disabled on the account or number. Enable messaging first, then resend.
30038 – OTP Message Body Filtered
The carrier filtered the message because of OTP rules. Adjust the wording to match approved formats and resend.
30039 – Filtered to Prevent Message Loops
The system blocked delivery to avoid a repeating loop. Change the message flow or timing, then resend.
30040 – Sender ID Pre-Registration Required
The carrier requires sender ID pre-registration. Complete the registration before sending messages to this destination.
For a full list of all error codes, please visit: https://www.twilio.com/docs/api/errors