Are you using Mailchimp and WPForms for your email marketing?
The WPForms Mailchimp addon makes it incredibly easy to create signup forms with our drag and drop form builder.
Recently Mailchimp released a more powerful integration API, v3.0.
In order to make sure that this release doesn’t affect your signup forms, we’ve updated our Mailchimp addon to work with the new API.
We’re asking that our Mailchimp addon users please update the addon and register the new Mailchimp integration so that your signup forms continue to work as expected.
We renamed the old integration to Mailchimp (Legacy). The new integration is called Mailchimp. The process for creating a new Mailchimp integration is exactly like the previous one.
Here’s how you can update your integration.
Connect to the New Mailchimp API
The first thing you’ll need to do is update your WPForms Mailchimp addon by opening Dashboard » Updates. For more details see this guide on how to install updates in WordPress.
Once the update has completed, you’ll need to go to WPForms » Settings, then select the Integrations tab.
On this page, you’ll notice that there are two Mailchimp listings: Mailchimp, which uses the new API, and Mailchimp (Legacy), which uses the old API.
To connect your account though the new API, you’ll need to open the Mailchimp listing and click on the + Add New Account button. To find your Mailchimp API key, follow these steps.
After you’ve added your account, you’ll get a green box that says “Connected”. It’s best to also leave the Mailchimp (Legacy) account connected for now, as we will need to transfer extra information inside your forms next.
Transfer Form’s Mailchimp Settings to New API
Now that you’ve connected the addon to Mailchimp’s new API, you’ll need to copy the settings within individual forms to a new section so they can use the new API as well.
To do this, open the form builder for any form utilizing the Mailchimp addon and go to Marketing. You’ll notice that there are now two Mailchimp connections, Mailchimp and Mailchimp (Legacy).
Mailchimp (Legacy) contains all of your existing settings for the old API. To transfer these to the new API, select Mailchimp and Add New Connection.
You’ll be prompted to enter a nickname for the form, and then you’ll be taken to the settings page. From here, you can click back to Mailchimp (Legacy)Â to copy any settings you had set up for this form.
Once you’ve copied any existing settings from Mailchimp (Legacy) to Mailchimp, you can delete the settings for the deprecated API. To do this, return to Mailchimp (Legacy) and click on the red ‘x’.
Be sure to save your form, then go ahead and repeat this process for any forms that have a Mailchimp connection.
Now that all of your form settings have been transferred to the new API, we can delete the deprecated connection. To do this, return to WPForms » Settings, then once again select the Integrations tab. If you open Mailchimp (Legacy), you’ll see a Disconnect link next to your account.
After clicking this link, your site will be disconnected from Mailchimp’s deprecated API. The Mailchimp (Legacy) option should disappear from this page (you may need to refresh the browser page).
That’s it! You’ve now transferred your forms to Mailchimp’s new API.
That’s all for this update, but there’s more coming soon. Don’t forget to subscribe to our email newsletter to be the first to know.
Thanks once again for all your support and feedback in making WPForms the best drag & drop form builder.
Jared and the WPForms Team
Unfortunately it doesn’t work – when I enter my API and Name and click on “save”, the button just changes to “Saving …” and gets stuck there.
Nothing happens even after a couple of minutes. Is that a mailchimp issue, or something wrong on your part?
Thanks for taking care of that!
Hey Christian,
I apologize for the trouble. There was a bug in the v1.1.0 release that gave some issues trouble like you are describing. We’ve already released an update (v1.1.1) which resolves the issue. Once you update it should work as expected. Thanks!
I haven’t yet received any update for WPforms – when can we expect this to arrive on WordPress 4.7.3?
Hi Mike,
This update was made available when this post was published, and should be visible under Dashboard » Updates. If the update does not appear for you, could you contact us in support? From there we can work with you can to see what’s going on, and manually update the plugin if needed.
Not sure why, but when I try to add a new API key into the new Mail Chimp integration it just spins and spins and spins. Doesn’t ever save. Any help??
Oops! Just saw the above comment. Thanks!
Hi Brett,
Sorry about that and I hope the new update fixed this for you! If you have any other questions, please feel welcome to contact us in support 🙂
Hi, I have a brand new install for wpforms and for the mailchimp addon v. 1.1.1, but when I hit the “connect to mail chimp” button, it stalls and does nothing.
Please help!
Hi Jorge,
It sounds like there might be an issue going on that’s specific to your site, and we’ll need to collect additional details to help you troubleshoot. If you could please contact us in support, we’ll help you sort this out 🙂
Thanks!
When I try to save my form after connecting it to the new “Mail Chimp” API account I get this message…
“Your form contains required MailChimp settings that have not been configured. Please double-check and configure these settings to complete the connection setup.”
What settings do I need to check?
Hey Kelly,
That means in your MailChimp configuration inside WPForms, there is a field that is set as “required” in MailChimp that you have not mapped in your form. If a field is not mapped, then the lead won’t be able to submit to MailChimp since it’s required.
Check out https://cl.ly/0w0Q0I0z3221 – in this example the sometext field is set to required in MailChimp (see the red asterisk). Make sure all fields that have that asterisk have a field mapped to it.
Hope that helps! 🙂
Hi I have the same problem as Kelly and I have checked the requireds fields in Mailchimp in my audience but I still get the same message
““Your form contains required MailChimp settings that have not been configured. Please double-check and configure these settings to complete the connection setup.””
Hi Frida!
This will be quite difficult to answer this question here in a comment.
If you have a WPForms license, you have access to our email support, so please submit a support ticket.
Otherwise, we provide limited complimentary support in the WPForms Lite WordPress.org support forum.
I hope this helps.
Have a good one 🙂