View all errors


SMS API


Error ID Information Actions
1 Details:

Throttled. You are sending SMS faster than the account limit.

Resolution:

Refer to What is the Throughput Limit for Outbound SMS? for more information.

2 Details:

Missing Parameters. Your request is missing one of the required parameters from, to, api_key, api_secret or text.

Resolution:

Check your parameters and try again.

3 Details:

Invalid Parameters. The value of one or more parameters is invalid.

Resolution:

Check your parameters and try again.

4 Details:

Invalid Credentials. Your API key and/or secret are incorrect, invalid or disabled.

Resolution:

Visit the Dashboard and check your credentials.

5 Details:

Internal Error. An error has occurred in the platform whilst processing this message.

Resolution:

If the error persists, contact support@nexmo.com.

6 Details:

Invalid Message. The platform was unable to process this message, for example, an un-recognized number prefix.

Resolution:

N/A

7 Details:

Number Barred. The number you are trying to send messages to is blacklisted and may not receive them.

Resolution:

N/A

8 Details:

Partner Account Barred. Your Nexmo account has been suspended.

Resolution:

Contact support@nexmo.com.

9 Details:

Partner Quota Violation. You do not have sufficient credit to send the message.

Resolution:

Top-up and retry.

10 Details:

Too Many Existing Binds. The number of simultaneous connections to the platform exceeds your account allocation.

Resolution:

Back-off and retry.

11 Details:

Account Not Enabled For HTTP. This account is not provisioned for the SMS API.

Resolution:

This error usually indicates that you should use SMPP instead.

12 Details:

Message Too Long. The message length exceeds the maximum allowed.

Resolution:

Send shorter messages.

14 Details:

Invalid Signature. The signature supplied could not be verified.

Resolution:

Check the documentation for signing messages or use one of the SDKs to handle the signing.

15 Details:

Invalid Sender Address. You are using a non-authorized sender ID in the from field.

Resolution:

This is most commonly seen in North America, where a Nexmo long virtual number or short code is required.

22 Details:

Invalid Network Code. The network code supplied was either not recognized, or does not match the country of the destination address.

Resolution:

Check the network code or remove it from your request.

23 Details:

Invalid Callback Url. The callback URL supplied was either too long or contained illegal characters.

Resolution:

Supply a valid URL for the callback.

29 Details:

Non-Whitelisted Destination. Your Nexmo account is still in demo mode. While in demo mode you must add target numbers to your whitelisted destination list.

Resolution:

Top-up your account to remove this limitation.

32 Details:

Signature And API Secret Disallowed. A signed request may not also present an api_secret.

Resolution:

Remove the API secret from your request, or don't sign the message.

33 Details:

Number De-activated. The number you are trying to send messages to is de-activated and may not receive them.

Resolution:

N/A