# 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="https://3488889492-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FEGgRVSDpMlcGFz1igK0s%2Fuploads%2FirzmRql72A99MyVxta6p%2F2025-05-05_13-53-21.png?alt=media&#x26;token=65212913-f0da-417d-92d9-42bf55c6fe1e" alt=""><figcaption></figcaption></figure>

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

<figure><img src="https://3488889492-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FEGgRVSDpMlcGFz1igK0s%2Fuploads%2F10Coll9B0r5fKCRVpsEN%2F2025-05-05_13-53-46.png?alt=media&#x26;token=b9f75a8b-5e4a-42a7-ad4f-d4871e3b8e5f" 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="https://3488889492-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FEGgRVSDpMlcGFz1igK0s%2Fuploads%2FP6MjgHBYIxfRPhi5jthe%2F2026-01-30_15-32-56.png?alt=media&#x26;token=c0c8c8c0-4349-45d0-891c-464188cd460c" alt=""><figcaption></figcaption></figure>

<figure><img src="https://3488889492-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FEGgRVSDpMlcGFz1igK0s%2Fuploads%2FOYD7np9a9G7ZhlfKnqXS%2F2026-01-30_15-35-23.png?alt=media&#x26;token=245cb282-e21d-4692-a662-071017beaeff" 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="https://3488889492-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FEGgRVSDpMlcGFz1igK0s%2Fuploads%2FKctfonoSgnmPah1qRiAH%2F2026-01-30_15-35-41.png?alt=media&#x26;token=e2bd0f25-32e5-4eed-81da-05a8a1c8ad5d" 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="https://3488889492-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FEGgRVSDpMlcGFz1igK0s%2Fuploads%2FBRp07JbuattJuNxH9H2Z%2F2026-03-26_14-19-31.png?alt=media&#x26;token=c2566dfb-8e21-4e98-978a-72063ba1758d" alt=""><figcaption></figcaption></figure>

New contact is added to Mailchimp audience list:

<figure><img src="https://3488889492-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FEGgRVSDpMlcGFz1igK0s%2Fuploads%2FXrCPaW8ub0rEW8HcZsv6%2F2026-03-26_14-18-01.png?alt=media&#x26;token=7f9e45f7-8edd-432d-9ed1-179117603af6" 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 [**support@powerfulform.com**](mailto:support@powerfulform.com). Our team will be happy to help you resolve any issues or guide you further.