MailChimp API v3.0 is now live!
Prior versions will no longer be supported after 2016, so all API users should begin transitioning to v3.0.
Check out the API v3.0 Documentation for more details.
« Back to Documentation Overview

exceptions

A mapping of known Exception classes to numerical codes that will be returned when errors occur. Note -98/Request_TimedOut must be implemented and managed by API clients and/or wrappers. For obvious reasons, the API can not currently return that.

General System Errors

CodeException
-32601ServerError_MethodUnknown
-32602ServerError_InvalidParameters
-99Unknown_Exception
-98Request_TimedOut
-92Zend_Uri_Exception
-91PDOException
-91Avesta_Db_Exception
-90XML_RPC2_Exception
-90XML_RPC2_FaultException
-50Too_Many_Connections
0Parse_Exception

100: User Related Errors

CodeException
100User_Unknown
101User_Disabled
102User_DoesNotExist
103User_NotApproved
104Invalid_ApiKey
105User_UnderMaintenance
106Invalid_AppKey
107Invalid_IP
108User_DoesExist
109User_InvalidRole

120: User - Action Related Errors

CodeException
120User_InvalidAction
121User_MissingEmail
122User_CannotSendCampaign
123User_MissingModuleOutbox
124User_ModuleAlreadyPurchased
125User_ModuleNotPurchased
126User_NotEnoughCredit
127MC_InvalidPayment

200: List Related Errors

CodeException
200List_DoesNotExist

210: List - Basic Actions

CodeException
210List_InvalidInterestFieldType
211List_InvalidOption
212List_InvalidUnsubMember
213List_InvalidBounceMember
214List_AlreadySubscribed
215List_NotSubscribed

220: List - Import Related

CodeException
220List_InvalidImport
221MC_PastedList_Duplicate
222MC_PastedList_InvalidImport

230: List - Email Related

CodeException
230Email_AlreadySubscribed
231Email_AlreadyUnsubscribed
232Email_NotExists
233Email_NotSubscribed

250: List - Merge Related

CodeException
250List_MergeFieldRequired
251List_CannotRemoveEmailMerge
252List_Merge_InvalidMergeID
253List_TooManyMergeFields
254List_InvalidMergeField

270: List - Interest Group Related

CodeException
270List_InvalidInterestGroup
271List_TooManyInterestGroups

300: Campaign Related Errors

CodeException
300Campaign_DoesNotExist
301Campaign_StatsNotAvailable

310: Campaign - Option Related Errors

CodeException
310Campaign_InvalidAbsplit
311Campaign_InvalidContent
312Campaign_InvalidOption
313Campaign_InvalidStatus
314Campaign_NotSaved
315Campaign_InvalidSegment
316Campaign_InvalidRss
317Campaign_InvalidAuto
318MC_ContentImport_InvalidArchive
319Campaign_BounceMissing

330: Campaign - Ecomm Errors

CodeException
330Invalid_EcommOrder

350: Campaign - Absplit Related Errors

CodeException
350Absplit_UnknownError
351Absplit_UnknownSplitTest
352Absplit_UnknownTestType
353Absplit_UnknownWaitUnit
354Absplit_UnknownWinnerType
355Absplit_WinnerNotSelected

500: Generic Validation Errors

CodeException
500Invalid_Analytics
501Invalid_DateTime
502Invalid_Email
503Invalid_SendType
504Invalid_Template
505Invalid_TrackingOptions
506Invalid_Options
507Invalid_Folder
508Invalid_URL

550: Generic Errors

CodeException
550Module_Unknown
551MonthlyPlan_Unknown
552Order_TypeUnknown
553Invalid_PagingLimit
554Invalid_PagingStart
555Max_Size_Reached
556MC_SearchException