Error codes

The following are possible error codes in the XML API. In most cases, the error description found in the Fault String element gives more details on the data causing the error for the particular API.

Error numberDescription
1FTF_NON_NUMERIC_MAILING_KEY
2FTF_NON_NUMERIC_SENDER_KEY
3FTF_BAD_MAILING
4FTF_INVALID_EMAIL_ADDRESS
5FTF_INVALID_ENCRYPTED_SENDER_KEY
6FTF_INVALID_COMMENT_SIZE
50Server Error (typically returned if the API is called incorrectly such as no XML passed in the request)
51Invalid XML request
52Missing XML parameter
100Parameter "x" was not provided in the API call
101Name already in use, cannot rename the template directory.
102Directory already exists.
103Parent directory does not exist.
104Visibility is not valid.
105The list type is not valid.
106List ID is not valid.
107Mailing ID is not valid.
108Tracking Level is not valid.
109Error saving mailing to the database.
110Retain flag is not valid.
111The mailing type is not valid.
112Click Through Type is not valid.
113TextSize is not an integer.
114Parameter "x" was not provided in the API call.
115Name already in use, cannot rename template directory.
116ERR_INVALID_CREATED_FROM
117ERR_INVALID_ALLOW_HTML
118ERR_INVALID_SEND_AUTOREPLY
119ERR_INVALID_UPDATE_IF_FOUND
120Error saving recipient to the database.
121Unable to add a recipient. No EMAIL provided.
122Unable to add a recipient. The recipient already exists.
123Unable to update recipient. The recipient does not exist.
124The recipient ID is not valid.
125No List ID or Mailing ID provided with the Recipient ID.
126Mailing does not exist.
127Mailing deleted.
128The recipient is not a member of the list.
129The recipient has opted out of the list.
130Unable to send mailing; internal error.
131ERR_INVALID_IMPORT_TYPE
132Unable to create the import job.
133The file type is not valid.
134The file type is not valid.
135The job ID is not valid.
136Unable to create Delete job. Internal error.
137Unable to destroy mailing. Internal error.
138Unable to remove the recipient from the list. Internal error.
139Unable to create DC ruleset export job.
140Editor type is not valid.
141Encoding is not valid.
143The list is a query, cannot delete the list query recipients.
145The session has expired or is invalid.
146Invalid default value for the List Column type.
147Include All Lists is not valid.
150Organization permissions prohibit using this API.
151ERR_LIST_META_DENIED
152Unable to create set column values job. Internal error.
153ERR_EXPORT_NOT_LIST_COLUMN
154The action code is not valid.
155Ruleset "x" does not exist.
156Unable to create the export job. Internal error.
160Can only send custom automated mailings. Provide the Mailing ID for a Custom AutomatedMailing.
161COLUMN_NAME is not valid for this list.
162Mailing is not active.
170SQLException deleting ruleset.
171Error deleting rule.
172Usage was not an integer.
173SQLException listing Dynamic Content ruleset.
174SQLException listing Dynamic Content rulesets for list.
180Unable to check if user exists. Internal error.
181You cannot schedule Multimatch Mailings through the API.
182A Mailing with the provided name already exists.
183Errors found validating mailing.
184Numerous errors related to dates.
185Report ID for Behaviour is invalid.
186ERR_INVALID_SENT_MAILING_TYPE
187The RECURSIVE flag is not valid.
188Cannot use a System field name for a List column.
190Unable to locate the element in the definition. Unable to continue.
211Unable to complete the request. Required unique key column values were not provided.
256Unable to create a query. The new List name already exists.
300A ruleset with the provided name already exists.
301A ruleset with the provided name does not exist.
310Invalid value for element LIST_ID. Not an integer. Value:"x"
311Unable to create recipient data job. Internal error.
312List is not the right type for this API.
313Column is not the right type for this API.
314Column "x" is not found in the list.
315Unable to opt-out recipient from the list. Internal error.
316Invalid XML in request. COLUMN element found without a NAME.
320Both MAILING_ID and LIST_ID are provided. Provide only one.
321The export format is not valid.
322Mailing content archived.
323Specified folder ID must be a number.
324Visibility of the list and parent folder must match.
325Specified folder ID does not exist.
326Unable to update recipient's EMAIL. EMAIL is part of the UniqueIdentifier.
329SYNC_FiELD element found without a NAME.
500Detailed report data for this mailing is not available this time. Try again later.
600Error saving query to the database.
806Autoresponder is not active.
1001Recipient ID not found in the list.
1002Sync ID not found in the list.
1003Error saving the recipient.
1004Error retrieving the recipient.
1005Error adding the recipient.
1006Missing recipient key info.
1007The column does not exist in the list.
1008Recipient not found in the list.
1009The recipient already deleted in Engage.
1011Cannot update system column.
1015Error merging recipient.
1016Missing required column value.
1017The email address is invalid.
1018Error adding the contact. The contact already exists in the contact list.