# 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)
* Trigger automated Mailchimp **Welcome Emails**, **Tags**, and **Journeys** with the list
* 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 (form)**

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

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

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

### 🔗 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/IAT7IUanXFCAEzzw7ERQ" 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.

***

### 🛠️ 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.


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.powerfulform.com/~/revisions/KRfi0fHdeAFeAhiPrH7G/app-integration/mailchimp-integration.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.