When you use a Transactional Messaging API to send a message, the response can include an error code. This table lists the possible error codes and provides an explanation of what each error indicates.
| Error Code | Error Message | Details |
|---|---|---|
| 1 | Unsubscribed | The subscriber’s status is unsubscribed. |
| 2 | Held | The subscriber’s status is held. |
| 3 | PartnerUnsubscribed | The subscriber’s status in the partner system is unsubscribed. |
| 4 | MissingEmailAddress | The subscriber doesn’t have an email address. |
| 5 | InvalidEmailAddress | The subscriber’s email address isn’t valid. |
| 6 | DuplicateEmail | The subscriber’s email address matches the email address of another subscriber in the request. |
| 7 | InvalidSubscriberIDProvided | The subscriber ID is invalid. |
| 8 | MissingSubscriberID | The subscriber key and subscriber ID are missing from the request. |
| 9 | MissingOwnerID | The ID for the child client account is missing in the request. |
| 10 | MissingRequiredAttributes | One or more required attributes for the subscriber are missing from the request. |
| 11 | NoAllSubscribersListEntry | The subscriber isn’t on the AllSubscribers list for the account. |
| 12 | InvalidOwnerIDProvided | The child client account isn’t a member of the enterprise account. |
| 13 | SubscriberKeyMismatch | The subscriber key doesn’t match the subscriber key in the request. |
| 14 | EmailAddressMismatch | The subscriber email address doesn’t match the email address in the request. |
| 15 | UnspecifiedError | The subscriber didn’t pass validation. Contact Salesforce Support. |
| 16 | InvalidAttributeValue | An attribute value for the subscriber doesn’t match the attribute type. |
| 17 | AttributeValueMaxLengthErr | A subscriber attribute exceeds the size limit for the attribute. |
| 18 | InvalidAttributeValueCount | The request contains an invalid number of subscriber attributes. |
| 19 | MissingRequiredFields | Required data extension fields for the subscriber are missing. |
| 20 | InvalidFieldValue | A data extension field value doesn’t match the field type. |
| 21 | DuplicateDataExtensionRow | You can’t insert a duplicate row into the triggered send data extension. |
| 22 | DataExtensionInsertFailed | Failed to insert a row into the triggered send data extension. |
| 23 | DomainExclusion | The subscriber was excluded because they were on a domain exclusion list. |
| 24 | ListDetectiveExclusion | The subscriber was excluded because they matched a List Detective rule. |
| 25 | SubscriberBlackedOut | The subscriber is in a blockout period, so the message wasn’t sent. |
| 26 | BuildEmailError | An error occurred when attempting to build an email for the subscriber. |
| 27 | SuppressionListExclusion | The subscriber was excluded because they’re on a suppression list |
| 28 | OptOutListExclusion | The subscriber was excluded because they’re on an opt-out list. |
| 29 | MissingSubscriberKeyValue | The subscriber key value is blank or null. |
| 30 | SubscriberKeyTooLong | The subscriber key value is too long. |
| 31 | ListLevelOptOut | The subscriber was opted out of the list. |
| 32 | MissingSendGroupID | Missing SendGroupID for the subscriber. |
| 33 | AccountLevelOptOut | The subscriber is unsubscribed at the account, enterprise, or business unit level. |
| 34 | MissingMessageFileName | The file name for the SMTP subscriber message is missing. |
| 35 | InvalidEmailAddressID | The EmailAddressID for the subscriber is missing or invalid in the request. |
| 36 | InvalidBusinessUnit | The subscriber was excluded because they’re not a member of the enterprise business unit. |
| 37 | QueuedTransactionDeleted | The message was removed from the queue. |
| 38 | InvalidSalesforceID | Invalid Salesforce ID for the subscriber key. |
| 39 | SubscriberQueueCleared | Unsent subscribers have been cleared from the queue. |
| 40 | SubscriberDeleted | The subscriber is deleted and can’t be added. |
| 41 | DuplicateSubscriber | The subscriber is a duplicate of a recent send. |
| 42 | RestrictedForProcessing | The subscriber is restricted for processing. |
| 43 | SubscriberRequestExpired | The triggered send request to the subscriber or contact has expired. |
| 44 | Unprovisioned Country | The account doesn’t support sending SMS messages to the country code in the subscriber's mobile number. |
| 45 | Invalid Mobile Number | The subscriber's mobile number isn’t valid. |
| 46 | Message Render Failure | The subscriber's message didn’t render properly. |
| 47 | Address Not Found | The subscriber's mobile address wasn’t found. |
| 48 | Send Failure | The message failed to send for an unspecified reason. |
| 49 | Message Expired | The message expired. |
| 50 | Invalid Send Time Data | The request contains an invalid send time. |
| 51 | Message Too Long | The message is too long and can’t be sent. |
| 52 | Message Too Short | The message is too short and can’t be sent. |
| 53 | Invalid Character for Encoding | The message contains characters that are invalid for the specified encoding. |
| 54 | Validation Error | There was a validation error when evaluating the message. |
| 55 | Feedback Loop | The message wasn’t sent because it’s configured in a way that could cause a feedback sending loop. |
| 56 | Token Resolution Failure | The request to resolve a token to a destination address failed. |
| 57 | Decryption Failure | An attempt to decrypt a field failed. |
| 100 | Error | An error occurred while building the email. |
| 101 | Failure | Failed to send email to the subscriber. |
| 102 | Excluded | Excluded by the send-time filter. |
| 103 | MessageBuildError | An error occurred when building the subscriber message. |
| 104 | RecursiveScriptError | A submitted script contains a self-reference that can lead to an infinite recursion. |
| 105 | InvalidSendTimeDataError | Invalid send time data XML file. |
| 106 | MissingSendDataExtensionSourceRowError | Missing source row for the subscriber in the data extension send source. |
| 107 | MissingSubscriberDataError | Missing members source row. |
| 108 | MissingListSubscriberDataError | Missing tblListSub source row. |
| 109 | MissingSubscriberKeyError | Missing subscriber key. |
| 110 | InvalidEmailAddressError | Invalid subscriber email address. |
| 111 | ScriptRaiseError | A RaiseError function call resulted in the message not being sent. |
| 112 | EmptyHTTPGetReturnError | An HTTPGet request for the subscriber returned an empty result. |
| 113 | EmptyHTTPGetFunctionReturnError | An HTTPGet function request for the subscriber returned an empty result. |
| 114 | MissingSFIDError | Missing subscriber’s Salesforce ID. |
| 115 | MissingSFDataError | Missing subscriber’s Salesforce data. |
| 116 | MissingSFSubscriberDataError | Missing subscriber’s SF Subscriber row. |
| 117 | CouldNotResolveSecureEmailToken | The account is configured for secure email addresses, but the secure email address token for the subscriber couldn’t be resolved. |
| 118 | GlobalUnsub | The subscriber’s email address is on the global unsubscribe list. |
| 119 | PartnerUnsub | The subscriber’s email address is on the partner unsubscribe list. |
| 120 | ListDetectiveExclusion | The subscriber’s email address was excluded because it matched a List Detective rule. |
| 121 | ProcessedByPairedMember | Another job already processed the subscriber. |
| 122 | SMTPFileNotFound | Can’t find the file that contains the subscriber’s SMTP message. |
| 123 | SMTPFileIOError | Can’t read the file that contains the subscriber’s SMTP message. |
| 124 | SMTPFileFormatError | The file containing the subscriber’s SMTP message was in an invalid format. |
| 125 | DecryptionFailed | Can’t decrypt an encrypted field on the sendable data extension. |
| 126 | MessageVolumeLimitExceeded | The message wasn’t sent because the email volume limit for the account has been reached. |
| 127 | EmptySubject | The email subject for the subscriber is empty. |
| 128 | ResolvedEmailBodyTooShort | The email body for the subscriber is too short. |
| 129 | PhoneNumberValidationFailed | The subscriber’s phone number failed validation at send time. |
| 130 | PayloadExceedsMaximum | The payload is too large. Make sure that the payload is less than the maximum data amount specified by your admin. |
| 131 | LinkDataExceedsMaximumSize | The payload for the compressed job subscriber link is too large. |
| 132 | InvalidCCEmailAddressError | The CC email address for the subscriber is invalid. |
| 133 | InvalidBCCEmailAddressError | The BCC email address for the subscriber is invalid. |
| 134 | SubscriberDeleted | The message wasn’t sent because the subscriber is being processed for deletion. |
| 135 | RestrictedForProcessing | The message wasn’t send because the subscriber is restricted for processing. |
| 136 | SubscriberKeyMismatch | The subscriber key or contact key doesn’t match the send data extension subscriber key. |
| 137 | SubscriberIDMismatch | The subscriber ID or contact ID doesn’t match the send data extension subscriber ID. |
| 138 | ExceededExpirationPolicy | The triggered send request expired. |
| 139 | TimedoutInQueue | The triggered send request timed out while waiting in the queue. |
| 140 | UnverifiedFromEmailAddress | The message wasn’t sent because the From email address isn’t verified. |
| 141 | V2TriggeredSendDeletedFromQueue | The CLEAR_TS_QUEUE slot worker deleted the subscriber. |
| 1000 | UnsubscribedList | The subscriber was excluded from the send because they’re unsubscribed from the AllSubscribers list. |
| 1020 | UnsubscribedGlobal | The subscriber was excluded from the send because they’re globally unsubscribed. |
| 1030 | Held | The subscriber was excluded from send because they’re in held status. |
| 1040 | Deleted | The subscriber was excluded from the send because they were deleted. |