Error Glossary

Review all global errors for the MailChimp API so you can get back to work fast. Check out the Getting Started guide for more information on error handling.

400

BadRequest

Your request could not be processed.

This is a generic error.

InvalidAction

The action requested was not valid for this resource.

This error is returned when you try to access an action that doesn’t exist. For example, /campaigns/{id}/actions/send.

InvalidResource

The resource submitted could not be validated.

For field-specific details, see field_warnings or field_errors objects. This error means that the object submitted to a POST or PATCH request failed to validate against JSON schema, and could relate to campaign, interest group, merge field, or any other available object.

JSONParseError

We encountered an unspecified JSON parsing error.

This error means that your JSON was formatted incorrectly or was considered invalid or incomplete.

401

APIKeyMissing

Your request did not include an API key.

This error suggests that your API key was missing from your request, or that something was formatted or named improperly in your header. Learn more about authentication for MailChimp API 3.0.

APIKeyInvalid

Your API key may be invalid, or you’ve attempted to access the wrong data center.

Check that your API key was input correctly, and verify which data center to access. Learn more about authentication for MailChimp API 3.0.

403

Forbidden

You are not permitted to access this resource.

This is a generic error.

UserDisabled

This account has been disabled.

The MailChimp account is deactivated. Contact our support team if you need more help.

WrongDatacenter

The API key provided is linked to a different data center.

This error suggests that you tried to contact the wrong data center. It’s often associated with misconfigured libraries.

404

ResourceNotFound

The requested resource could not be found.

This error tells you a specific resource doesn’t exist. It’s possible that the resource has been moved or deleted, or that there’s a typo in your request.

405

MethodNotAllowed

The requested method and resource are not compatible. See the Allow header for this resource’s available methods.

This error means that the requested resource does not support the HTTP method you used. Find out which methods are allowed for each resource in the API Reference.

414

ResourceNestingTooDeep

The sub-resource requested is nested too deeply.

This uncommon error appears if you’ve tried to generate a URL with too many resources.

422

InvalidMethodOverride

You can only use the X-HTTP-Method-Override header with the POST method.

This error lets you know you’ve tried to override an incompatible method. The MailChimp API only permits method override with POST.

RequestedFieldsInvalid

The fields requested from this resource are invalid.

This error suggests there is a typo in your field request or some other type of syntax error or problem that invalidates your request.

429

TooManyRequests

You have exceeded the limit of 10 simultaneous connections.

When you reach the connection limit, we’ll throttle server response. If any of your requests time out after you’ve reached the limit, those requests could still be considered open and continue to slow your connection. Contact the MailChimp API support team at apihelp@mailchimp.com if you think this is the case.

500

InternalServerError

An unexpected internal error has occurred. Please contact Support for more information.

This error lets you know our servers have experienced a problem. Although this is rare, please contact apihelp@mailchimp.com to let us know that you’ve encountered this error.

503

ComplianceRelated

This method has been disabled.

You will see this error when your account is under compliance review.