Transactional API Subscriber Error Codes
A subscriber error code occurs when a message can't be delivered due to an incorrect email address or other incorrect user setup. 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 | Tse 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 number of subscriber attributes doesn’t match the number of attributes that are expected. |
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 SMTP subscriber message file name 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. Ensure that the payload is less than the maximum data amount specified by your admin. |
131 | LinkDataExceedsMaximumSize | The compressed job subscriber link data 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. |