Twilio SMPP API error codes indicate problems that happen during SMS message processing. These codes help you to identify and fix issues like connection errors or message rejections. At the end of a request, you'll receive an error code if something goes wrong, which helps in troubleshooting and maintaining smooth system communication. See the list of common errors below.
| Code | Description |
|---|---|
| 000 | No error. |
| 001 | Absent subscriber. The HLR responded to the SRI for SM request with an error indicating the subscriber is absent. |
| 002 | Handset memory capacity exceeded. Handset has run out of free memory to store new message. |
| 003 | Connection timeout. |
| 004 | WebSocket connection to Twilio's signaling servers were unexpectedly ended. If this is happening consistently, there may be an issue resolving the hostname provided. If a region is being specified in Device setup, ensure it's a valid region. |
| 005 | No transport available to send or receive messages. |
| 006 | No error. |
| 007 | Absent subscriber. The HLR responded to the SRI for SM request with an error indicating the subscriber is absent. |
| 008 | Handset memory capacity exceeded. Handset has run out of free memory to store new message. |
| 009 | Connection timeout. |
| 010 | WebSocket connection to Twilio's signaling servers were unexpectedly ended. If this is happening consistently, there may be an issue resolving the hostname provided. If a region is being specified in Device setup, ensure it's a valid region. |
| 011 | No transport available to send or receive messages. |
| 012 | WebSocket connection to Twilio's signaling servers were unexpectedly ended. If this is happening consistently, there may be an issue resolving the hostname provided. If a region is being specified in Device setup, ensure it's a valid region. |
| 013 | No transport available to send or receive messages. |
| 014 | No error. |
| 015 | Absent subscriber. The HLR responded to the SRI for SM request with an error indicating the subscriber is absent. |
| 016 | Handset memory capacity exceeded. Handset has run out of free memory to store new message. |
| 017 | Connection timeout. |
| 018 | WebSocket connection to Twilio's signaling servers were unexpectedly ended. If this is happening consistently, there may be an issue resolving the hostname provided. If a region is being specified in device setup, ensure it's a valid region. |
| 019 | No transport available to send or receive messages. |
| 020 | WebSocket connection to Twilio's signaling servers were unexpectedly ended. If this is happening consistently, there may be an issue resolving the hostname provided. If a region is being specified in device setup, ensure it's a valid region. |
| 021 | No transport available to send or receive messages. |
| 047 | TCAP error. |
| 049 | SMS discarded. This error is specific to IP-based protocols like SMPP. |
| 050 | SMS window exceeded. |
| 051 | SMS malformed. SMS isn't formed correctly. This error is specific to IP-based protocols like SMPP. |
| 052 | SMS expired. |
| 053 | Insufficient credit. The user has insufficient credit or isn't allowed to send to that destination. |
| 054 | Invalid destination. Receiver isn't a valid number. |
| 055 | Unable to find outbound route for this SMS. |
| 056 | SMS buffered. |
| 057 | Timeout waiting for response from peer. |
| 058 | Throttling Error. The user has exceeded allowed message limit. |
| 059 | Absent Subscriber: The message is undeliverable because the subscriber is temporarily absent, e.g. their phone is switched off, they can't be located on the network. |
| 060 | Portability error: The message failed due to the ported combinations being unreachable. |
| 061 | Invalid PDU format. |
| 062 | ESME client error. |
| 063 | Local ACL deny. |
| 064 | Invalid payload length. |
| 065 | Remote logic error. |
| 066 | Remote logic deny. |
| 067 | DCS inconsistency. |
| 068 | Route error, please contact Twilio support. |
| 069 | Rejected - SMSC rejected the SRI for SM request. |
| 070 | PSA connection failed. |
| 162 | Abort - The HLR (or some other entity in the network) aborted the SRI for SM request. |
| 205 | Illegal subscriber. |
| 206 | Illegal equipment. |
| 218 | Screening error. Terminating IMSI blocked. |
| 255 | Unknown error. |
| 711 | Destination network or country is blocked. Contact Twilio customer support to unblock this network/country. |
| 712 | Insufficient credits to send message. |
| 713 | SMS sent and no delivery report received. |
| 714 | Route loop detected. |
| 716 | Flood protection. Multiple identical messages to recipient detected. |
| 717 | Invalid srcAddr. |
| 718 | Invalid msisdn/destAddr. |
| 800 | The end user doesn't exist. |
| 801 | The end user is blocked. |
| 802 | The end user belongs to a network operator that doesn't allow charge. |
| 803 | The end user isn't allowed to purchase premium services. |
| 826 | Message body error. |
| 828 | Message too long. |
| 925 | Operator network failure. |
| 928 | Blocked due to spam. |