Twilio Error Codes

Modified on Tue, 18 Jul 2023 at 05:19 AM

These are the more popular codes that have been seen. Here is a link to the view the other code https://www.twilio.com/docs/api/errors#3-anchor

ERROR CODE	ERROR DESCRIPTION	POSSIBLE CAUSES	POSSIBLE SOLUTIONS
30002 Account Suspended	Your account was suspended between the time of message send and delivery. Please contact Twilio. This message failed because your account was suspended after this message was queued but before it was sent by Twilio	Account was suspended for lack of funds after your message was queued but before it was sent ny twilio Account was suspended because Twlio detected a violation of their Acceptable Use Policy	Please contact Twilio support
30003 Unreachable Destination Handset	The destination handset you are trying to reach is switched off or otherwise unavailable	The destination handset you are trying to reach is switched off or otherwise unavailable The device you are trying to reach does not have sufficient signal *There is an issue with the mobile carrier	The first step to troubleshooting this issue is to attempt to replicate the problems. Attempt to send another test message to this user first. Can the device receive non-Twilio SMS/ Can the device receive messages from another Twilio number (non-Alphanumeric Sender ID), or with a shorter one-segment (non-concatenated) body? If the problem persists, try verifying if the number you are sending out SMS to is NOT a landline. Use this website:https://www.phonevalidator.com/
30006 Landline or Unreachable Carrier	SMS being sent to Landline or Short Code	*The destination number is unable to receive this message. Potential reasons could include trying to reach a landline or, in the case of short codes, an unreachable carrier	*Make sure that the number you are sending out SMS to is not a Landline or Short Code number
30007 Message Filtered	Message Filtered	* Your message was filtered (blocked) by Twilio or by the carrier * Twilio's filtering system is in place to protect mobile subscribers from spam or other forms of malicious or unwanted messages *Wireless carriers have filtering systems in place as well. The carrier filters are used to block abusive traffic, as well as enforce rules or regulations about what type of messaging are allowed to that country or mobile network.	Please refer to this article which provides Twilio Do's and Don'ts that will help prevent your messages from getting filtered. In addition, the following Twilio links will also provide additional information: Ensure your messaging use case complies with Twilio's Messaging Policy and Acceptable Use Policy Review the information in How Does Message Filtering Work? to understand what causes filtering. *See How do I prevent my Twilio messages from being filtered (blocked)? for specific tips on avoiding message filtering.
30034 US A2P 10DLC - Message from an Unregistered Number	Messages sent to US numbers will not be delivered if they are sent from numbers that are not associated with a registered A2P 10DLC Campaign. This guide will help you determine if you have registered for A2P 10DLC. To initiate or continue an A2P 10DLC registration, visit your console here. Find out how to register using this guide.	Your “From” number is not associated with a registered A2P 10DLC Campaign.	Associate your “From” number to a registered A2P Campaign via the Twilio Console or API. Find out how to register using this guide. Use a “From” number associated with a registered A2P Campaign applicable to your use case to send messages in the US.