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	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.