--- schema_version: "1" id: 6b1280a76eefae4dccfcd0f16569488df5ab2f406599a8a8f535f55898c3f292 title: Transactional API Subscriber Error Codes collection: developer version: current locale: en-us portal_url: https://docs.salesforce.com/developer/current/en-us/marketing-cloud/guides/mc-apis/transactional-send-subscriber.md canonical_url: https://developer.salesforce.com/docs/marketing/marketing-cloud/guide/transactional-send-subscriber.html source_site: developer.salesforce.com content_type: documentation content_hash: 0b39cc9b128807f6e43278315971a2b352b52d605d04184c280a5948c187ddf4 products: - Marketing Cloud Engagement APIs and Programmatic Languages - Marketing Cloud --- # Transactional API Subscriber Error Codes 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. | ## See Also - [Transactional Messaging Email API](/docs/marketing/marketing-cloud/references/mc_rest_transactional_messaging_email) - [Transactional Messaging Push API](/docs/marketing/marketing-cloud/references/mc_rest_transactional_messaging_push) - [Transactional Messaging OTT API](/docs/marketing/marketing-cloud/references/mc_rest_transactional_messaging_ott) - [Transactional Messaging SMS API](/docs/marketing/marketing-cloud/references/mc_rest_transactional_messaging_sms)