API Errors

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

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

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

Check your parameters and try again.

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

Check your parameters and try again.

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

Visit the Dashboard and check your credentials.

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

If the error persists, contact support.

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

N/A

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

N/A

Partner Account Barred. Your Vonage account has been suspended.

Contact support.

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

Top-up and retry.

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

Back-off and retry.

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

This error usually indicates that you should use SMPP instead.

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

Send shorter messages.

Invalid Signature. The signature supplied could not be verified.

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

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

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

Message Blocked by Provider. The messaging provider has chosen to block this message. This may be due to content or restrictions imposed by the provider.

N/A

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

Check the network code or remove it from your request.

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

Supply a valid URL for the callback.

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

Top-up your account to remove this limitation.

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

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

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

N/A