> For the complete documentation index, see [llms.txt](https://docs.powerfulform.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.powerfulform.com/app-integration/mailchimp-integration.md).

# Mailchimp integration

With the Mailchimp integration, you can add subscribers directly to your Mailchimp audience the moment they submit your form.

### ✅ What You Can Do

With Mailchimp integration, you can:

* Add subscribers to any Mailchimp **Audience**
* Sync form data (email, name, phone, custom fields)
* Keep your email list clean and always up to date

***

### 📝 Step 1: Get Your Mailchimp API Key

To begin, you'll need an API key from your Mailchimp account:

1. Log in to your Mailchimp account
2. Navigate to **Account** > **Extras** > **API Keys**
3. Click **Create A Key**
4. Copy the generated key for use in the next step

Reference: <https://mailchimp.com/help/about-api-keys/#Find_or_generate_your_API_key>

***

### 📝 **Step 2: Add Mailchimp API key to the app settings**

1. Open the app > click **Settings** > hover on **Mailchimp** settings > click **Config**

<figure><img src="/files/8xxzWEndcBeaB3mtoSro" alt=""><figcaption></figcaption></figure>

In **Mailchimp API key** field, enter API key created in the **Steps 1** above

<figure><img src="/files/nDa4lrIVU7fbSRYBvfZT" alt=""><figcaption></figcaption></figure>

3. Click **Save** to update the changes

***

### 📝  **Steps 3 - Select Mailchimp list**&#x20;

Before Map the data, please make sure you create the contact list ([a signup form)](https://mailchimp.com/help/create-a-hosted-signup-form/) in **Mailchimp** to connect the data from the Globo form with that list.

Follow this [link](https://mailchimp.com/help/create-a-hosted-signup-form/) to know more.

1\. Open the app > click **Forms** > open the form you want to deal with

2\. Click **Integration** icon on the left side > enable **Mailchimp** by toggling it on and clicking its name

3\. select a Mailchimp list in **List** dropdown&#x20;

<figure><img src="/files/Ww13xBhe8dEWYecSbW5g" alt=""><figcaption></figcaption></figure>

<figure><img src="/files/Y2GWloAraFXRXCeOrm3q" alt=""><figcaption></figcaption></figure>

***

### 📝 Step 4: Map Form Fields to Mailchimp Fields

Select the value of the Globo form (on the right) to connect it to the fields in **Mailchimp** (on the left)

* The **Email** value is compulsory here to create a new profile in **Mailchimp**
* The other values are optional. Please map them based on your needs

For example: the **First name**  field of **Mailchimp** is matched with **First name** field of the form, the **Last name**  field of **Mailchimp** is matched with **Last name** field of the form.

<figure><img src="/files/AB3sD59G2mbolJUrG6qI" alt=""><figcaption></figcaption></figure>

***

### 📝 Step 5: Publish & Test Your Form

If the form is already published, you just need to save the form after making changes.

***

### ✅ How It Works <a href="#how-it-works" id="how-it-works"></a>

After a user submits the form, the form sends data to Mailchimp.&#x20;

* Mailchimp creates or updates the subscriber profile.
* Log in to your Mailchimp account > go to **Audience** > **All contacts**.
* Open the list you integrated with your form > check for the new subscriber profile to confirm data has been added successfully.

Submission detail in the form app:&#x20;

<figure><img src="/files/9glLCa5AcJRZ4HqT2wYe" alt=""><figcaption></figcaption></figure>

New contact is added to Mailchimp audience list:

<figure><img src="/files/1WD9HEly2d4yoDPspSnm" alt=""><figcaption></figcaption></figure>

***

### 🔧 Troubleshooting

#### ❌ Subscriber not appearing in Mailchimp

Check:

* The **Email** field is mapped to EMAIL (required)
* You submitted a valid email
* Audience is selected
* API key has the correct permissions
* The email is not part of your "Unsubscribed" or “Cleaned” list

#### ❌ “Invalid API key” error

Double-check:

* You used a **Mailchimp API Key**, not a password
* There are no extra spaces when you pasted the key
* The key has not been revoked or expired

#### ❌ Audience list not loading

Try:

* Generating a new API key
* Checking if your Mailchimp account has at least one active audience

***

### ❓ FAQs

#### **Can I add subscribers to multiple Mailchimp audiences?**

No. Mailchimp allows each contact to belong to **one primary audience**.\
But you can use **tags** or **segments** inside Mailchimp to organize subscribers.

#### **Do I need an email field?**

Yes. Mailchimp requires an **EMAIL** field to add a subscriber.

#### **Will existing Mailchimp profiles be updated?**

Yes.\
If a profile already exists, the app will update the fields you mapped.

***

#### Need More Help?

If you still need assistance, please contact us at <contact@globo.io>. Our team will be happy to help you resolve any issues or guide you further.