Mailchimp API Key: How to Find Your API Credentials

Your Mailchimp API key is the credential that allows the Contact Form 7 Mailchimp Extension to communicate with your Mailchimp account. In other words, without a valid Mailchimp API key, the plugin cannot access your audience lists, add new subscribers, or sync form submissions from your WordPress site.

Additionally, Mailchimp uses a straightforward API key authentication model. You generate a key in your Mailchimp account settings and paste it into the plugin. As a result, the entire setup process takes less than two minutes — no OAuth flows, no authorization codes, no callback URLs.

Furthermore, this guide walks you through finding your Mailchimp API key step by step, entering it into the Contact Form 7 Mailchimp Extension, and troubleshooting common issues.

Where to Find Your Mailchimp API Key

Your Mailchimp API key is located in the account settings area. Specifically, follow these steps to find it:

1. Log in to Mailchimp at mailchimp.com.
2. Click your profile icon in the bottom-left corner of the dashboard.
3. Select Account & billing from the menu.
4. Click Extras in the top navigation, then select API keys.
5. Click Create A Key — Mailchimp generates a new API key that you can copy immediately.

In addition, there is a shortcut: go directly to admin.mailchimp.com/account/api/ while logged in. This takes you straight to the API keys page without navigating through menus.

Moreover, you need Admin or Manager permissions to generate API keys. If you are logged in as a Viewer or Author, the “Create A Key” button does not appear. Ask your account administrator to either generate a key for you or upgrade your permissions.

What a Mailchimp API Key Looks Like

A Mailchimp API key is a long string that follows this format:

5998xxxxxxxxxxxxxxxxxxxxxxxxxxxx-us4

Specifically, it contains a series of alphanumeric characters followed by a hyphen and a data center identifier (like us4, us21, or eu1). The suffix after the hyphen tells the plugin which Mailchimp server to connect to. In fact, if you remove or change this suffix, the API connection fails.

Consequently, always copy the complete key including the data center suffix.

Entering Your Mailchimp API Key in WordPress

After copying your Mailchimp API key from the Mailchimp settings page, follow these steps:

1. Open your WordPress admin and navigate to Contact > Contact Forms.
2. Edit the form you want to connect to Mailchimp.
3. Click the Mailchimp tab that the extension added to the form editor.
4. Paste your Mailchimp API key into the API Key field.
5. Click Save — the plugin validates the key and loads your available audience lists.

As a result, a dropdown appears with your Mailchimp audiences. Select the audience you want form submissions sent to. You can also target a specific audience by its Mailchimp List ID for precise control.

Using Different API Keys Per Form

Each Contact Form 7 form can use a different Mailchimp API key. This is useful in several scenarios:

• Multiple Mailchimp accounts — if you manage separate accounts for different brands or departments, each form connects to the right account.
• Client work — agencies building sites for clients can connect each client’s contact form to that client’s Mailchimp account.
• Security isolation — if one API key is compromised, only the forms using that key are affected.

Similarly, the Campaign Monitor API key and AWeber API key setups support the same per-form configuration.

Common Mailchimp API Key Issues

Invalid API key error

If the plugin shows an “invalid API key” error after saving, check for trailing spaces, line breaks, or a missing data center suffix. Specifically, copy the Mailchimp API key directly from the Mailchimp settings page and paste it without modifications. In fact, invisible whitespace characters are the most common cause of authentication failures.

API key works but audiences do not load

This typically means your Mailchimp account has no audiences created yet. Consequently, create at least one audience in Mailchimp before configuring the plugin. Mailchimp requires every account to have at least one audience for the API to return results.

Key stopped working after account changes

If you changed your Mailchimp account password or downgraded your plan, existing API keys may become invalid. In addition, Mailchimp occasionally retires old API versions. Generate a new key and update the plugin settings.

Mailchimp API Key Security

Your Mailchimp API key grants full access to your subscriber data. Therefore, follow these security practices:

• Never share your API key publicly — do not post it in forums, support tickets, or social media.
• Create dedicated keys per integration — if you use multiple plugins that connect to Mailchimp, give each one its own API key. As a result, you can revoke one key without affecting the others.
• Regenerate compromised keys — if you suspect your Mailchimp API key has been exposed, disable it immediately in Mailchimp and generate a new one.
• Label your keys — Mailchimp lets you add a description to each API key. Use descriptive names like “CF7 Mailchimp Extension – Main Site” so you know which key belongs to which integration.

Most importantly, the Contact Form 7 Mailchimp Extension stores your API key securely in the WordPress database as post meta data. It transmits the key only to Mailchimp’s official API endpoint over HTTPS.

Next Steps

After entering your Mailchimp API key, you may also want to configure these features:

• Find your Mailchimp List ID — select audiences by ID for precise subscriber routing.
• Add a Mailchimp opt-in checkbox — let visitors choose whether to subscribe.
• Map Mailchimp custom fields — send additional form data beyond name and email.

Additionally, if you need help with your Mailchimp API key or any other aspect of the plugin, contact us directly.