Channel Specific Status Codes

This document details the channel-specific status codes and the associated reasons for message delivery failure.

Common Error Codes across Channels

Error CodeMeesage
7000Invalid JSON
7001Authentication failed
7002Service Key Missing
7003Mandatory parameters missing
7004Invalid parameters/Values
7005Request expired
7006Internal error occurred
7007Service inactive
7009Max number of destination address limited to 1000
7020You have reached the maximum transaction limit
7104Invalid app id
7200Unknown Status

SMS

Status CodeMessageDescriptionDelivery Status
7500DeliveredReturned when the message is transmitted to the destination network and confirmation of delivery provided from the mobile handsetDelivered
7501SubmittedReturned when the message has is in an interim status indicating submission to network provider, prior to it being actually delivered to the handsetSubmitted
7004Invalid parameters/ValuesReturned when an invalid value or parameters are providedFailed
7006Internal server errorReturned when the message failed at the gateway and was not transmitted to the destination operator. This is may be an intermittent temporary errorFailed
7101Invalid Sender IDReturned when the sender is not authorized or configured at the destination operator or the wrong sender Id is being used for this requestFailed
7102Invalid addressReturned when the address is invalidFailed
7109User in DnDReturned when the user is registered on Do Not Disturb listUn-Delivered
7201Delivery failed at OperatorReturned when the message was routed to the operator but was rejected for various network-specific reasons (temp. failure or other network related issue)Un-Delivered
7202Delivery failed at platformReturned when the delivery failed at platformUn-Delivered
7203Unknown Subscriber addressReturned when the number is an invalid mobile number on the destination network. This may indicate the subscriber is no longer valid, the number has ported away, or may have service blocks preventing message deliveryUn-Delivered
7204Insufficient Credits in subscriber accountReturned when a message is sent to a prepaid mobile subscriber who no longer has a credit balance on their SIM card and can no longer receive messagesUn-Delivered
7205Error in Binary messageReturned when there is an error in binary message.Un-Delivered
7206Can't deliver. Subscriber SIM FullReturned when the subscribers SIM is fullUn-Delivered
7207Subscriber out of coverage area or not reachableReturned when the subscriber is out of coverage areaUn-Delivered
7208Message expiredReturned when the message could not be delivered to the handset and exceeded its delivery time limit. This occurs when a subscriber has their handset turned off, or handset has no more memory to accept messagesUn-Delivered
7209Unable to deliver multipart messageReturned when the message was sent as a multi-part message (either a long text message more than 160 chars which is split into multiple parts, or a message with specific character encoding) to the network destination and one or more of the parts was returned undeliverable. The specific error for the non-delivery is not disclosed and all parts of the message will be flagged with this error codeUn-Delivered
7210Billing Configuration errorReturned when there is an error in billing configurationUn-Delivered
7211Billing error at operatorReturned when message could not be delivered as network operator has indicated there was a billing related errorUn-Delivered

In addition to the existing SMS error codes, client tenants hosted in the United States and Canada regions have these additional error codes for SMS:

Status CodeMessageDescriptionDelivery Status
7111Spam content detectedReturned when the Sender has exceeded or violated carrier rules on message velocity, or content rules and has been blocked at the network level by the operatorUn-Delivered
7280Message deletedReturned when a network operator deletes the message for technical reasons related to network performanceUn-Delivered
7281Campaign errorReturned when the Sender ID (phone number) is not registered with an approved 10 DLC brand and campaign ID with the campaign registry and is blocked from transmitting messages to the operatorUn-Delivered
7282Invalid routeReturned when invalid routeUn-Delivered
7283Invalid operator or landlineReturned when invalid operator or numbers is landlineUn-Delivered
7284Duplicate MT (caught by Duplication Guard)Returned when message caught by duplicate guardUn-Delivered
7302Rate limit exceededReturned when the sender ID used to send traffic has exceeded its authorized TPS limit. 10 DLC registered numbers which are subject to rate limits will return such errors when exceeding the limits associated with their approved campaign IDs. There could be other throughput restrictions as wellUn-Delivered
7513Unregistered deviceReturned when the device is unregisteredUn-Delivered
7518UnknownReturned when an unknown error occursUn-Delivered
7607Invalid message typeReturned when the Message type is not accepted by the operator (like Binary messages, or unicode)Un-Delivered
7720Recipient blocked to receive messageReturned when the recipient blocked to receive messageUn-Delivered

Voice

CodeMessage
7000Invalid JSON
7003Dynamic Format - “Mandatory parameter missing: {{parameter}}”
7004Dynamic Format - “Invalid parameter: {{parameter}}”
7127Source IP not whitelisted
7016Unknown exception
7020You have reached maximum transaction limit
7101Invalid sender ID
7102Invalid destination address
7104Invalid app ID
8009The profile doesn’t exist for this tenant
7107Message length exceeded
7108Invalid template ID
7126Invalid content type
7009Maximum number of destinations reached
7022JSON size exceeded
7005Request expired
7519Call answered

Push

Status CodeMessageDescription
7500DeliveredThe push was successfully delivered to the device.
7501SubmittedThe push was successfully submitted to the push service (APNS/FCM/HMS) for delivery
7502ReadGenerated when the user interacts with the push on the device. Note that this status does not occur if the user dismisses the push.
7503Message expired before delivery attemptReturned when the message is expired before attempting a delivery.
7504Authentication errorReturned when an authentication error occurs.
7505Too large payload ( >4kb)Returned when the payload is more than 4kb for Android.
7506Invalid time to live valueReturned when an invalid value is passed for time to live parameter for Android
7507Too many requests for the AppReturned when too many requests are received for the same app.
7508GCM server errorReturned when an error occurs in Google Cloud Messaging server
7509Too many concurrent requests for same customerReturned when too many requests are received for the same customer.
7510Too big payloadReturned when the payload is more than 4kb for iOS.
7511Invalid time to live valueReturned when an invalid value is passed for time to live parameter for iOS.
7512Invalid push idReturned when the push id is invalid.
7513Unregistered DeviceReturned when a device is not registered.
7514Wrong apns certificate gatewayReturned when a wrong APNS certificate is provided.
7515Bad apns certificateReturned when an APNS certificate is invalid.
7516Too many request for the same deviceReturned when too many requests are received by the same device.
7517APNS server errorReturned when an APNS server error occurs.
7518UnknownReturned when an unknown error occurs.
7537Some tokens are successfully sent. Tokens identified by illegal_token are those failed to be sent
7538Some token parameters are incorrect
7539The number of tokens must be 1 when a synchronization message is sent
7540Incorrect message structure
7541The message expiration time is earlier than the current time
7542The collapse_key message field is invalid
7543The message contains sensitive information
7544OAuth authentication error
7545OAuth token expired
7546The current app does not have the permission to send push messages
7547All tokens are invalid
7548The message body size exceeds the default value
7549The number of tokens in the message body exceeds the default value
7550You are not authorized to send high-priority notification messages
7551System internal error

In-App Messaging and Live Chat

Status CodeMessage
7500Delivered
7501Submitted
7502Read
7000Invalid input details
7006Internal server error
7010Service provider exception
7011Unknown Exception
7301Message expired
7304Invalid app credentials(Invalid OAuth)
7305Invalid user credentials
7307End point not reachable
7308Invalid topic
7309No topic subscribers found
7310No segment found
7311Thread or streamname required
7312Invalid thread id
7000Invalid JSON (Generic Template)
7003param 'mediaid' or type based attachment is required (Generic Template)
7004param 'title' in notification, is missed or empty (Generic Template)
7034Max allowed elements reached - Upto 8 elements are allowed in attachments (Generic Template)
7703Max allowed buttons in a section reached - Upto 3 buttons allowed in element (Generic Template)
7704Duplicate identifiers not allowed (Generic Template)
7708Max allowed image urls reached - Upto 5 allowed URLs in element (Generic Template)
7004invalid value for param 'type' in rt attachment, only image, location, file, video and audio are allowed (Quick Replies)
7003param 'mediaid' or type based attachment is required (Quick Replies)
7704Duplicate identifiers not allowed (Quick Replies)
7706Max allowed quick replies reached - max 5 quick replies will be allowed (Quick Replies)
7026Request Json parameter size exceeded 4 KB (Quick Replies)

Email

Status CodeMessageDescription
7500DeliveredReturned when e-mail is delivered
7501SubmittedReturned when e-mail sent to the gateway
7520BounceThe following bounce types are possible:
- Undetermined: Indicates Amazon SES was unable to determine a specific bounce reason.
- Permanent (general): Indicates Amazon SES received a general hard bounce and recommends that you remove the recipient's email address from your mailing list.
- Permanent (no email): Indicates Amazon SES received a permanent hard bounce because the target email address does not exist. It is recommended that you remove that recipient from your mailing list.
- Permanent (suppressed): Indicates Amazon SES has suppressed sending to this address because it has a recent history of bouncing as an invalid address.
- Transient (general): Indicates Amazon SES received a general bounce. You may be able to successfully retry sending to that recipient in the future.
- Transient (mail box full): Indicates Amazon SES received a mailbox full bounce. You may be able to successfully retry sending to that recipient in the future.
- Transient (message too large): Indicates Amazon SES received a message too large bounce. You may be able to successfully retry sending to that recipient if you reduce the message size.
- Transient (content rejected): Indicates Amazon SES received a content rejected bounce. You may be able to successfully retry sending to that recipient if you change the message content.
- Transient (attachment rejected):
Indicates Amazon SES received an attachment rejected bounce. You may be able to successfully retry sending to that recipient if you remove or change the attachment.
7521ComplaintThe following complaint types are possible:
- Abuse: Indicates unsolicited email or some other kind of email abuse.
- Auth-failure: Email authentication failure report.
- Fraud: Indicates some kind of fraud or phishing activity.
- Not-spam: Indicates that the entity providing the report does not consider the message to be spam. This may be used to correct a message that was incorrectly tagged or categorized as spam.
- Other: Indicates any other feedback that does not fit into other registered types.
- Virus: Reports that a virus is found in the originating message.
7522Email address is not verifiedThis occurs when the account is in sandbox mode. Returned when destination email address is not verified.
7523Invalid email addressReturned when destination email address is invalid. The email ID should be in the format: [email protected] where “abc” is the unique combination of string and numerics or one of the two, while “xyz” is the domain or server to be linked to. As part of the syntax, “@” and “.” are mandatory to ensure the validity of the email address.
7524Email address max length reachedReturned when the maximum email length has been reached. According to the example above - “[email protected]”, the maximum length of “abc” should be less than or equal to 64 characters and the maximum length of “xyz.com” should be less than or equal to 255 characters. The total character length of the email address should not exceed 320 (inclusive of “@”).
7535attachment length exceededReturned when overall email size including attachment exceeds the limit. For clients post version 5.63, the limit is 40MB.
7536Exception while parsing the EMAIL Template, unable to fetch template
7240EmailId in bounce blacklistReturned when the email has bounced
7241EmailId in unsubscribe blacklist* Returned when the destination email is found in Webex Connect unsubscribe list.
7553SMTP Authentication Failed
7554SMTP Failures

Messenger

Status CodeMessage
7000Invalid input details(JSON not correct)
7006Internal server error
7010Service provider exception
7011Unknown Exception
7301Message expired
7303Endpoint not reachable
7313Inbound message not received from the user
7500Delivered
7501Submitted
7502Read
7526Either subscription messaging permission not enabled or invalid tag received from the request
2018336The action is not submitted due to new privacy rules in Europe. See developer documentation for more information.98
2018047The action is not submitted due to new privacy rules in Europe. See developer documentation for more information.

Google Business Messages

Error CodeMessage
7900No error
7904Request not authenticated due to missing, invalid, or expired OAuth token.
7905Client does not have sufficient permission. This can happen because the OAuth token does not have the right scopes, the client doesn't have permission, or the API has not been enabled.
7906A specified resource is not found.
7909Either out of resource quota or reaching rate limiting. The client should look for google.rpc.QuotaFailure error detail for more information.
7910Request cancelled by the client.
7913API method not implemented by the server.
7914Network error occurred before reaching the server. Typically a network outage or misconfiguration.
7915Service unavailable. Typically the server is down.
7916Request deadline exceeded. This will happen only if the caller sets a deadline that is shorter than the method's default deadline (i.e. requested deadline is not enough for the server to process the request) and the request did not finish within the deadline.
7901Client specified an invalid argument. Check error message and error details for more information.
7902Request can not be executed in the current system state, such as deleting a non-empty directory.
7903Client specified an invalid range.
7907Concurrency conflict, such as read-modify-write conflict.
7908The resource that a client tried to create already exists.
7911Unrecoverable data loss or data corruption. The client should report the error to the user.
7917Unknown server error. Typically a server bug.
7912Internal server error. Typically a server bug.
7501Submitted
7500Delivered
7502Read

Instagram

Error CodeMessage
7000Invalid input details(JSON not correct)
7307End point not reachable
7302Rate limit exceeded
7301Message expired
7303Delivery notification of a message expired
7006Internal server error
7304Invalid app credentials(Invalid OAuth)
7305Invalid user credentials
7306Duplicate message
7011Unknown Exception
7501Submitted
7500Delivered
7502Read
7010Service provider exception
7526Either subscription messaging permission not enabled or invalid tag received from request
7313Inbound message not received from user

Twitter DM (Currently not supported)

Status CodeMessage
7000Invalid input details (JSON not correct)
7006Internal server error
7010Service provider exception
7011Unknown Exception
7301Message expired
7302Rate limit exceeded
7304Invalid app credentials(Invalid OAuth)
7306Duplicate message for Twitter
7307Endpoint not reachable
7501Submitted

Apple Messages for Business

Status CodeMessage
7000Invalid input details(JSON not correct)
7006Internal server error
7010Service provider exception
7011Unknown Exception
7301Message expired
7307Endpoint not reachable
7316Invalid application details
7317Merchant API session failed
7501Submitted
7738Failed to upload media
1001Queued
7000Invalid JSON
7001Authentication failed
7002Service key missing
7003Mandatory parameters missing
7004Invalid parameters
7007Service inactive
7009Max number of destinations
7722Parameter value is invalid

WeChat

Status CodeMessage
7000Invalid input details(JSON not correct)
7006Internal server error
7010Service provider exception
7011Unknown Exception
7301Message expired
7307Endpoint not reachable
7501Submitted
7601Verification failed
7602Invalid WeChat User ID
7603Invalid media file type
7604Invalid file type
7605Invalid file size
7606Invalid media file ID
7607Invalid message type
7608Invalid image file size
7609Invalid audio file size
7610Invalid video file size
7611Invalid thumbnail file size
7612Invalid App ID
7613Invalid access token
7614Invalid OAuth code
7615Invalid refresh token
7616Invalid OpenID list
7617Invalid OpenID list length
7618Invalid request characters: The character uxxxx cannot be included
7619Invalid parameters
7620Invalid request format
7621Invalid URL length
7622Parameter missing: access token
7623Parameter missing: appid
7624Parameter missing: refresh token
7625Parameter missing: secret
7626Multimedia file data missing
7627Parameter missing: media id
7628The other user is not yet a follower
7629The other user is not yet a follower
7630Rich media message is empty
7631The text message is empty
7632Error source: multimedia file size
7633Message contents too long
7634Title too long
7635Description too long
7636URL too long
7637Image URL too long
7638Audio playtime over the limit
7639Rich media messages over the limit
7640Error source: interface call
7641Message quantity over the limit
7642This user does not exist
7643Invalid image file type (invalid file type)

WhatsApp

Error descriptions for each state are sent in additional info in the webhook

Status CodeMessageDescription
7500DeliveredReturned when the message is delivered to the destination WhatsApp number.
7501SubmittedMessage submitted to WhatsApp for delivery.
7502ReadMessage read by the recipient.
7010Service provider exception
7011Unknown Exception
7701Media download errorFailed to download the media from the sender.
7704Message is not validMessage failed to send because it was pending for too long.
7705Message expiredMessage failed to send during its Time To Live (TTL) duration.
7706Rate limit hitMessage failed to send because there were too many messages sent from this phone number in a short period of time.
Resend the failed messages.
7710Re-engagement messageMessage failed to send because more than 24 hours have passed since the customer last replied to this number. Use a message template to respond.
7711Spam Rate limit hitMessage failed to send because there are restrictions on how many messages can be sent from this phone number. This may be because too many previous messages were blocked or flagged as spam. Check your quality status in the WhatsApp Manager.
7714Message too longLength of the message exceeds 4096 characters.
7715Invalid recipient typeThe recipient type is not valid.
7721Required parameter is missing
7722Parameter value is not valid. The namespace does not correspond to the WABA id.Value entered for a parameter is of the wrong type or other problem.
7726User is not valid
7736Generic error

RCS

Status CodeMessage
7000Invalid input details - JSON
7006Internal server error
7010Service provider exception
7011Unknown Exception
7301Message expired
7307Endpoint not reachable
7500Delivered
7501Submitted
7502Read
7740Invalid media details
7318General Bad Request error for everything not caught in the specific error below
7319Not Found
7320Invalid JSON
7321Invalid JSON Content (bad field, invalid phone number)
7322Provider not configured for chatbot
7323Unable to locate carrier for the recipient
7324Max TPS reached
7325Unauthorized access
7326Internal System Error
7327External System error
7328Pass the error detail we have as error
7329Carrier lookup process failure
7330Includes: details from MaaP
7331Rate limited at MaaP and retries expired
7334MaaP returned a Failure IMDN

MMS

Status CodeMessage
7144Delivery to the country code not supported
7145Slide message max text size exceeded
7146Max slides exceeded
7147Quota exceeded at route level
7148Invalid attachment type
7150Subject max text size exceeded
7212Invalid request. Make a valid request via GET/POST/XML with all the required variables
7213User Authentication Failed
7214This account has no API rights
7215You can call API every X seconds
7216This account has no rights to use this action
7217XML Parse error: $error
7218API not activated
7219Invalid receiver number
7220Invalid short code
7221IP was not whitelisted. API call rejected
7222Set throughput exceeded for this API action. API call rejected
7223Phone number is blacklisted. API call rejected
7224Account has reached the API request limit
7225More than one object is not allowed in the same slide
7226MMS audio/video/image are not allowed with object in the same slide
7227Too many Slides
7228Audio and Video not allowed in same slide
7229Video and Image not allowed in same slide
7230Text more than X characters
7231Content not allowed
7232Bad X slide duration
7233This content does not exist
7234The name is required
7235No slides
7236Slide X is empty
7237Image in slide X is too big
7238Audio in slide X is too big
7239Video in slide X is too big
7242Text in slide X is too long
7243vCard in slide X is too big
7244iCal in slide X is too big
7245PDF in slide X is too big
7246Passbook file in slide X is too big
7247Image file in slide X is corrupted
7248Could not copy Image in slide X
7249Could not copy Audio in slide X
7250Could not copy Video in slide X
7251Could not copy vCard in slide X
7252Could not copy iCal in slide X
7253Could not copy PDF in slide X
7254Could not copy Passbook file in slide X
7255Internal error
7256mmslink_expiration_date is invalid
7257Carrier lookup failed. Please retry
7258Carrier not provisioned
7259The fallbacksmstext is required
7260Invalid serviceid / serviceid is required
7261Operator Not supported
7262Unrecognized content type
7263The ‘operator id’ is required
7264Number is not subscribed in this campaign
7265The campaignref is required
7266Invalid campaignref
7267Message failed at vendor
7268Message rejected or not supported at vendor
7269API access is blocked for this account. Please check the status of this account or its master account if applicable
7270Message delivery expired by operator
7271Message delivery expired by application