API Errors

Throttled - You have exceeded the submission capacity allowed on this account. Please wait and retry

Missing params - Your request is incomplete and missing some mandatory parameters.

Invalid params - The value of one or more parameters is invalid.

Invalid tag - The tag value is invalid.

Invalid template - Invalid template or template parameters

Internal error - There was an error processing your request in the Platform.

Invalid message - The Platform was unable to process your request. For example, due to an unrecognised prefix for the phone number.

Number barred - The number you are trying to submit to is blacklisted and may not receive messages.

Partner account barred - The api_key you supplied is for an account that has been barred from submitting messages.

Provider quota exceeded - your allocated quota may have been exceeded.

Account not enabled for REST - This account is not provisioned for REST submission, you should use SMPP on the SMS API.

Message too long - The length of udh and body was greater than 140 octets for a binary type SMS request.

Communication Failed - Message was not submitted because there was a communication failure.

Illegal Sender Address - rejected - Due to local regulations, the SenderID you set in from in the request was not accepted. Please check the Global messaging section.

Invalid TTL - The value of ttl in your request was invalid.

Facility not allowed - Your request makes use of a facility that is not enabled on your account.

Invalid Message class - The value of message-class in your request was out of range. See https://en.wikipedia.org/wiki/Data_Coding_Scheme.

Non White-listed Destination - The phone number you set in to is not in your pre-approved destination list. To send messages to this phone number, add it using Dashboard.

Invalid recipient - The to parameter is missing or contains an invalid address or identifier.

Destination temporarily unavailable - The destination cannot currently receive messages. Retry later.

Absent Subscriber Permanent - to is no longer active, You should remove this phone number from your database.

Portability Error - There is an issue after the user has changed carrier for to. If the user wants to receive messages from you, they need to contact their carrier directly.

Anti-Spam Rejection - Carriers often apply restrictions that block messages following different criteria. For example on SenderID or message content.

Handset Busy - The handset associated with to was not available when this message was sent. If status is rejected, this is a temporary failure; retry later for a positive result. If status is submitted, this message has is in the retry scheme and will be resent until it expires in 24-48 hours.

Temporary network failure - The message could not be delivered due to a network issue. Retry later.

Illegal Number - You tried to send a message to a blacklisted phone number. That is, the user has already sent a STOP opt-out message and no longer wishes to receive messages from you.

Too many send requests - Too many send requests to phone numbers.

Number pool does not exists - check that the number pool has been configured for your account

Unroutable - The chosen route to send your message is not available. This is because the phone number is either currently on an unsupported network or on a pre-paid or reseller account that could not receive a message.

Unable to route traffic to a destination - This may be due to the routing rules applied for your destination network.

Destination unreachable - The message could not be delivered to the phone number. If using Viber Business Messages your account might not be enabled for this country.

Subscriber Age Restriction - The carrier blocked this message because the content is not suitable for to based on age restrictions.

Number Blocked by Carrier - The carrier blocked this message. This could be due to several reasons. For example, to's plan does not include SMS or the account is suspended.

Message rejected by provider - The provider blocked the message may be due to policy or content restrictions.

Pre-Paid - Insufficient funds - to's pre-paid account does not have enough credit to receive the message.

Not part of the provider network - The number or ID is not a user in the provider network.

Not suitable device - The user's device can't receive the message.

Message already sent - The message was already sent.

Delivery failed - The provider returned an unknown permanent failure. Verify the destination and retry if appropriate.

Provider error - The provider is not responding or unable to process the request. Please try sending your message in a few minutes time.

Outside of the allowed window - This message is sent outside of allowed response window.

Phone matching fee not paid - Requires phone matching access fee to be paid by the Facebook Page.

TTL was activated, or message expired before delivered.

Expired access Token - Please reauthenticate your Facebook Page with Vonage.

Invalid resource - Please check that the URL your provided to your resource is accessible and valid.

Resource size is too large - Please try sending a smaller media file.

Unsupported resource type - The attached resource type is not supported or invalid.

Unsupported channel - The channel specified in the request is not supported.

Invalid channel parameters - The value of one or more parameters is invalid.

Invalid sender - The from parameter is invalid for the given channel.

Invalid recipient - The to parameter is invalid for the given channel.

Multiple recipients error - Multiple recipients not supported.

Invalid message type - The message type specified in the request is not supported for the given channel.

Invalid client reference - The client reference can be a string of up to 100 characters.

Invalid context - the reference to the original message could not be found because it is invalid or no longer available.

Daily message limit exceeded - Check compliance with regulations such as 10DLC.

Auto-limiting of messages by Provider - This message was not delivered by Provider to avoid excessive messages to the end user. For details please see this knowledgebase article.

Fraud Defender Traffic Rule - Rejected due to Fraud Defender traffic rules block.

Fraud Defender SMS Burst Protection - Traffic limit has been reached

AIT Protection - The message has been rejected by Fraud Defender AIT Protection

Fraud Defender Traffic Rule - Rejected due to Fraud Defender country block.

Fraud Defender Traffic Rule - Rejected due to Fraud Defender network block.

Do Not Originate (DNO) - Originating number is on a DNO list.

Entity Filter - The message failed due to entity_id being incorrect or not provided. More information on country specific regulations.

Header Filter - The message failed because the header ID (from phone number) was incorrect or missing. More information on country specific regulations.

Content Filter - The message failed due to content_id being incorrect or not provided. More information on country specific regulations.

Consent Filter - The message failed due to consent not being authorized. More information on country specific regulations.

Authentication or compliance failure - The message failed authentication or regulatory checks. Verify sender configuration or contact support.

SMS segment timeout - Not all segment delivery receipts were received within the allowed time. The overall delivery status of this message is unknown. Partial delivery is possible.

HARD_BOUNCE / RECIPIENT_MISSING — Invalid recipient. The to parameter is missing or contains an invalid email address or identifier. Verify the destination address and retry.

Fraud protection triggered - The message was blocked by fraud or abuse protection rules at the provider side.

SOFT_BOUNCE / CONTENT_TOO_LARGE - The message or payload exceeds the allowed size limit. Reduce the payload and retry.

HARD_BOUNCE - Recipient email address is in the suppression list; may be due to an earlier email being hard bounced or marked as spam by the user.

HARD_BOUNCE / UNKNOWN - Unknown permanent delivery failure. The provider returned a non-specific permanent error. Verify the destination address and retry if appropriate.

SOFT_BOUNCE / MAILBOX_FULL - Destination temporarily unavailable. The recipient's mailbox is at capacity and cannot receive messages. Retry after 48 hours.

SOFT_BOUNCE / ATTACHMENT_REJECTED - Attachment rejected. The attached file type is not supported or unable to download or was blocked by the receiving server. Check the attachment format and retry.

SOFT_BOUNCE / GATEWAY_TIMEOUT - Temporary network failure. The recipient's mail server did not respond in time. This is a temporary failure; retry later.

SOFT_BOUNCE / CONTENT_REJECTED - Message rejected by provider. The provider blocked the message due to content policy or spam restrictions. Review the email content and retry.

SOFT_BOUNCE / UNKNOWN - Temporary delivery failure. A temporary infrastructure or network error occurred. Retry later.

COMPLAINT / AUTH_FAILURE - Authentication or compliance failure. The message failed SPF, DKIM, or DMARC authentication checks. Verify your DNS configuration and sender settings, or contact support.

COMPLAINT / NOT_SPAM_CORRECTION - Not spam correction received. The recipient marked a previous complaint as incorrect. Sender reputation has been updated positively. No action required.

COMPLAINT / VIRUS_DETECTED - Malicious content detected. An attachment or link in the message was flagged as malicious by the provider. Audit the email content and attachment generation pipeline.

COMPLAINT / OTHER_FEEDBACK -Miscellaneous provider feedback received. The provider returned unclassified feedback for this message. Logged for analytics; no immediate action required.

UNSUBSCRIBE / USER_UNSUBSCRIBED — The recipient has unsubscribed from this sender. The email was not delivered. No further emails should be sent to this address from this account and identity until the recipient opts back in.