Plugins Plugin hub Backup SEO Caching Security Forms WooCommerce Images Best backup plugins
Hosting Hosting directory Shared hosting Managed WordPress Cloud hosting VPS hosting By reader location Hosting finder
Themes & builders Compare Rank Math vs Yoast
Tools All tools Hosting finder Plugin stack builder Cost calculator Salt generator Theme detector Who is hosting this? Speed test Headline analyzer robots.txt generator Redirect generator Uptime calculator Blog name generator
Blog Best backup plugins Deals
Guides All guides Speed up WordPress Choose hosting Back up WordPress
How we test

Developer · Info

Mailchimp for WordPress API Settings Explained: What Each Option Does

Mailchimp for WordPress API Settings Explained: What Each Option Does

Short answer

The Mailchimp for WordPress API settings live under MC4WP > Mailchimp. You paste a Mailchimp API key, the Status shows whether the plugin connected, and the audience list shows the lists, fields and groups your forms can use. Refresh it after changing anything in Mailchimp.

Key takeaways

  • The MC4WP plugin connects to Mailchimp with an API key, not a login.
  • The key's suffix tells the plugin which Mailchimp data center to use.
  • Refresh the audience list after adding audiences, fields or groups in Mailchimp.
  • Double opt-in and update options are set per form or integration.
  • The debug log under MC4WP > Other shows the exact Mailchimp error.

What are the Mailchimp for WordPress API settings?

The API settings are the screen in the MC4WP plugin where you paste your Mailchimp API key, check the connection status, and see the audiences the plugin can reach.

MC4WP: Mailchimp for WordPress is a free plugin by ibericode. It does not use a login button. Instead, it talks to Mailchimp through an API key that you create in your Mailchimp account.

You find the screen in your dashboard under MC4WP > Mailchimp. Every other part of the plugin, including forms and integrations, depends on this connection working.

The screen is short, but each part has a job. The sections below explain what each one does and what to check when something looks wrong.

What does the API Key field do?

The API Key field stores the secret key that lets the plugin read your audiences and add subscribers to your Mailchimp account on your behalf.

Mailchimp API keys are long strings that end with a dash and a short code such as us6 or us21. That suffix is your account's data center. The plugin uses it to know which Mailchimp server to contact.

You create a key in Mailchimp under your profile's extras, in the API keys area. Mailchimp's guide about API keys shows the current menu path and explains how to revoke old keys.

Treat the key like a password. Anyone with it can add, edit or remove contacts in your account. After saving, the plugin masks most of the key on screen.

A few rules for the key:

  • Create one key per site so you can revoke it without affecting other tools
  • Name the key after the site in Mailchimp
  • Never paste it into public support forums
  • Revoke and replace it if a former contractor had access

What does the Status indicator mean?

Status shows whether the plugin could reach Mailchimp with your key, reading Connected when the key works and Not connected when the request failed or the key is missing.

Connected means the plugin sent a test request to Mailchimp and got a valid answer. Forms should now be able to subscribe people.

Not connected has a few common causes:

  • The key was copied with a missing character or extra space
  • The key was revoked or deleted in Mailchimp
  • The server cannot make outgoing HTTPS requests
  • A firewall or security plugin is blocking the request

If the key looks right, create a fresh one in Mailchimp and paste it again. That rules out a typo or a revoked key in one step.

Server-side blocks are less common but harder to spot. Some hosts restrict outgoing connections, which WordPress plugins make through the HTTP API. Your host can confirm whether requests to Mailchimp's API are allowed.

What is the audience list on the settings page?

Below the key, the plugin shows the Mailchimp audiences it found, along with their IDs, merge fields and interest groups, so you know exactly what forms can use.

Mailchimp used to call audiences lists, and the plugin still uses that word in places. Each audience shows:

ItemWhat it means
NameThe audience name in Mailchimp
IDThe unique audience ID used by the API
Subscriber countRoughly how many contacts it holds
Merge fieldsFields such as FNAME and LNAME you can fill from forms
Interest groupsGroups subscribers can choose, if set up

Use this list to check field tags. If your form uses a field name that does not match a merge field tag here, Mailchimp ignores that data.

What does the renew or refresh lists button do?

The refresh button clears the plugin's stored copy of your Mailchimp audiences and fetches them again, so new audiences, fields or groups show up in WordPress.

The plugin caches audience data to avoid calling Mailchimp on every page load. That makes it fast, but it means changes in Mailchimp do not appear in WordPress straight away.

Click the refresh button after you:

  • Create a new audience
  • Add or rename a merge field
  • Add interest groups or change their names
  • Delete an audience

If an audience still does not appear, check that the API key belongs to the same Mailchimp account as the audience. People with several accounts often mix them up.

How do form and integration settings use the API connection?

Forms and integrations each pick which audience to subscribe people to, and add choices like double opt-in and updating existing contacts, all sent through the API connection.

The API screen only connects the account. The choices that control what happens to subscribers sit in each form and integration. The most important ones are:

Audience selection. Each form or integration must have at least one audience ticked. If none is selected, sign-ups fail.

Double opt-in. When on, Mailchimp sends a confirmation email and the person only joins after clicking it. This is usually the safer choice for consent.

Update existing subscribers. When on, a person who signs up again has their details updated instead of getting an error.

Replace interest groups. Decides whether new group choices replace old ones or add to them.

Integrations connect the plugin to comment forms, registration forms, WooCommerce checkout and form plugins. Each integration has its own copy of these options. Our guide on connecting WPForms to Mailchimp shows another way to send form entries to Mailchimp.

Where does the plugin log API errors?

Under MC4WP > Other you can turn on the debug log, which records failed requests to Mailchimp with the error message Mailchimp returned.

The log is the fastest way to see why a sign-up failed. Messages usually name the problem clearly, such as an invalid email address, a merge field marked required in Mailchimp, or a contact who unsubscribed earlier and cannot be re-added through the API.

Set the log level to record errors, reproduce the problem, then read the log. Turn detailed logging down again afterwards so the log does not grow forever.

For problems outside the plugin, WordPress's own debug log helps too. Our guide on enabling debug mode in WordPress explains how to switch it on safely.

How do you change or remove the API key?

To change the key, paste a new one into the API Key field and save, then refresh the audiences; to remove it, clear the field, save, and revoke the key in Mailchimp.

Change the key when:

  • You move the site to a different Mailchimp account
  • A team member who had access leaves
  • You suspect the key was exposed

After switching accounts, every form and integration needs a new audience selected. The old audience IDs belong to the previous account and will not work.

Revoking the old key in Mailchimp is the important step. Removing it from WordPress alone does not stop someone else who copied it from using it.

Which API problems are most common?

The usual problems are a wrong or revoked key, a stale audience cache, required Mailchimp fields missing from the form, and hosts that block outgoing requests.

A quick checklist:

  1. Status says Connected
  2. The right audience is selected in the form
  3. Every field marked required in Mailchimp is in the form
  4. You refreshed audiences after changes in Mailchimp
  5. The debug log shows no errors

If everything here passes and sign-ups still fail, see our guide on fixing the Mailchimp WordPress plugin when it is not working.

Developers who want to dig deeper can read the plugin's source on GitHub or Mailchimp's Marketing API documentation, which documents the endpoints the plugin calls.

For a wider look at setup options, read how to add Mailchimp to WordPress.

Frequently asked questions

Where do I find my Mailchimp API key?

Log in to Mailchimp, open your profile menu and go to the extras area, then choose API keys. Create a new key, give it a name that matches your site, and copy it into the MC4WP settings.

Why does MC4WP say not connected?

The key is usually wrong, revoked or copied with a space. Create a fresh key and paste it again. If it still fails, your host or a security plugin may be blocking outgoing requests to Mailchimp.

Why is my new audience missing in the plugin?

The plugin caches your audiences. Click the refresh button on the Mailchimp settings page to fetch them again. Also confirm the key belongs to the same Mailchimp account that holds the new audience.

Is it safe to store my API key in WordPress?

It is normal practice, but anyone with admin access can use it. Limit admin accounts, create one key per site, and revoke the key in Mailchimp if you think it was exposed.

Do I need a paid Mailchimp plan for the API?

No. Mailchimp API keys are available on free accounts, and the free MC4WP plugin works with them. Your Mailchimp plan still limits contacts and features, so check Mailchimp's pricing page for current limits.

Sources

  1. MC4WP: Mailchimp for WordPress WordPress.org Plugins
  2. About API keys Mailchimp
  3. Marketing API documentation Mailchimp Developer
  4. mailchimp-for-wordpress repository GitHub

Is your product missing, or something out of date?

Tell us what to add or correct. We read every note and reply when we need a source. A message does not buy a ranking.

About the editors

Written and checked byWPLegible Editorial Team Independent WordPress reviews and guides

Researched from the primary sources listed above and checked against our editorial rules before publishing.