How to debug MailChimp error


This document provides instructions on how to detect and debug errors, that may appear when member subscribes to the MailChimp audience using the MailChimp extension.


Debugging #

Update "Ultimate Member" and "Ultimate Member - MailChimp" plugins to the latest version

How to update plugin

[Plugins > Installed Plugins]

Plugins, Installed Plugins

How to update plugin from the .zip archive

  • go to the admin page "Plugins"
  • deactivate old version (if it is)
  • delete old version (if it is)
  • click the "Add New" button
  • click the "Upload Plugin" button
  • click the "Choose file" button - additional window should appear
  • select an archive with the new version
  • click the "Install Now" button - installation will start
  • activate plugin after the installation

Please look to the documentation for more details.

Enable "Requests log"

The extension "Ultimate Member - MailChimp" may save requests to the MailChimp server to the file /wp-content/uploads/ultimatemember/mailchimp.log. Use a log to investigate issues.

[Ultimate member > Settings > Extensions > MailChimp]

Verify your audience settings in MailChimp and WordPress

Pay attention to required fields and choices for the "radio buttons" and "drop down" field types. Synchronization between Ultimate Member and MailChimp would fail if one of the required fields is empty. Synchronization between Ultimate Member and MailChimp may fail if the value of the "radio buttons" or "drop down" field type doesn't match. The widget has several tools that helps you to configure fields relationship and avoid mistakes:

  • required fields marked by the icon !
  • additional information about field type and choices may be seen under  the icon ?
  • a warning appears under the field if configuration is wrong

[Ultimate Member > MailChimp > Edit audience]

[Ultimate Member > MailChimp > Edit audience (with warning)]

Ultimate Member, MailChimp, Edit audience

Try to subscribe and unsubscribe member from the Account page

Error message appears if update fails for some reason. Verify your audience settings in the MailChimp and WordPress. Pay attention to "Merge User Meta", especially on required fields and choices for the "radio buttons" and "drop down" field types.

[Account page > Notifications]


Try to register new member

Test your site`s Registration form. Look to the "Requests log" if new member was not subscribed to the audience.

Investigate "Requests log"

"Ultimate Member - MailChimp" extension saves requests to the MailChimp server to the file  /wp-content/uploads/ultimatemember/mailchimp.log. You may overview this file on the extension`s settings page. Use log to debug MailChimp API issues. Requests with errors are colored in red. Usually you may find the reason of the issue in the RESPONSE data.

[Ultimate member > Settings > Extensions > MailChimp]

MailChimp errors #

Member In Compliance State #

MailChimp adds an email address to the black list if a member use the link “unsubscribe from this list” in the email footer. 

This email address can't be resubscribed via API. You should see an error message if you try to resubscribe using fields in the account tab Notifications.

We can't influence this logic from the site. A member can resubscribe by clicking the button "Subscribe" in the email "You are now unsubscribed" that Mailchimp sends after the contact is unsubscribed.

Read the article "Resubscribe a Contact" to get know how to resubscribe email addresses manually.