> ## Knowledge Base Index
> Fetch the complete knowledge base index at: https://help.hoppyapps.com/sitemap.xml
> Use this file to discover available pages before exploring further.
> Pure-Markdown content can be obtained by appending a '.md' suffix to the content URLs listed in the sitemap (without the trailing slash).

# 🔗 Integrate PopUps App with Mailchimp

Connecting Hoppy PopUps with **Mailchimp** lets you automatically sync popup subscribers directly into your chosen Mailchimp audience list. Once connected, every email (and phone number) collected through your popups flows straight into Mailchimp — ready for campaigns, automations, and segmentation.

---

# **⚠️ Before You Begin**

Before connecting Mailchimp with Hoppy PopUps, make sure:

* You have an active **Mailchimp** account  
* The **Hoppy PopUps** app is already installed on your Shopify store

You will need:

→ **Your Mailchimp API Key**

You can find this in **Mailchimp → Account → Extras → API Keys**.

⚠️ **Important:**

Your Mailchimp API key includes a server prefix at the end (for example, `us14`). The app uses this prefix automatically to connect to the correct Mailchimp data center. Make sure your API key contains this suffix.

---

# **🛠️ Step 1 — Open the Integrations Section**

Open the **Hoppy PopUps** app from your Shopify Admin.

Then:

→ Click the **Integrations** tab from the left-side navigation menu

Locate the **Mailchimp Integration** card.

If not connected yet, the card will display:

→ **Not Connected**

---

# **🔑 Step 2 — Enter Your Mailchimp Credentials**

Inside the Mailchimp Integration card, fill in the following fields:

### **Mailchimp Account Email**

Enter the email address associated with your Mailchimp account.

### **Mailchimp API Key**

Paste your full API key including the server prefix.

### **Example**

`a1b2c3d4e5f6g7h8i9j0k1l2m3n4o5p6-us14`

Then:

→ Click **Connect**

The app will validate the connection by pinging Mailchimp. If successful, the status badge changes to:

→ ✅ **Connected**

---

# **📋 Step 3 — Select Your Audience List**

After connecting:

→ The app will fetch all available audiences from your Mailchimp account  
→ Open the **Select Existing Audience** dropdown  
→ Choose the audience where subscribers should be added

Examples:

* Newsletter  
* Welcome Series  
* Prospects  
* VIP List

⚠️ **Important:** If no list is selected, subscriber data may not sync properly even if the integration is connected.

---

# **🔄 Step 4 — Enable Auto-Sync**

To automatically send every new popup submission to Mailchimp in real time:

→ Toggle **Auto Sync** to **ON**

hen enabled:

* Every new subscriber is added to the selected Mailchimp audience immediately  
* Members are added with **Subscribed** status  
* Phone numbers are passed into Mailchimp as **merge fields** when collected

If you leave Auto Sync off, you can still push subscribers manually using the **Sync Previous Emails** button.

---

# **📤 Step 5 — Sync Previous Emails (Optional)**

If you already have subscribers collected before enabling this integration:

→ Click **Sync Previous Emails**

The app will:

* Push all existing subscriber emails from your database to the selected Mailchimp list  
* De-duplicate against existing Mailchimp members before adding  
* Process requests with a 1-second delay between each to respect Mailchimp rate limits

---

# **✅ Step 6 — Save the Integration**

After selecting your list and configuring sync preferences:

→ Click **Save**

Your Mailchimp integration is now active.

---

# **🧪 Step 7 — Test the Integration**

To verify the connection is working:

→ Open your storefront in an **Incognito or Private** browser window  
→ Trigger a popup and submit a test email address

Example:

`testmailchimp@example.com`

Then:

→ Log in to your **Mailchimp Dashboard**  
→ Go to **Audience → All Contacts**  
→ Open the audience you selected  
→ Search for the test email  
→ Verify it appears with **Subscribed** status

---

# **⚠️ Common Troubleshooting**

## **Subscribers Not Appearing in Mailchimp**

If new subscribers don't show up:

→ Verify the correct **API Key** was used (including the server prefix)  
→ Verify a **Mailchimp List** is selected in the integration settings  
→ Verify **Auto Sync** is enabled, or manually run a sync  
→ Verify the popup is **published** and actively receiving submissions

## **Connection Failed**

If the app cannot connect to Mailchimp:

→ Double-check that the API key is complete and includes the `-usXX` suffix  
→ Make sure the Mailchimp account is active and not suspended  
→ Try regenerating a new API key in Mailchimp and pasting the fresh key

## **Phone Numbers Not Syncing**

If emails sync but phone numbers don't:

→ Verify the popup collects phone numbers (enabled in Content tab)  
→ Note that phone numbers are sent as merge fields — ensure your Mailchimp audience supports phone merge fields

---

# **🎉 Final Result**

Once configured successfully:

✅ Popup subscribers automatically sync to your Mailchimp audience  
✅ Auto-sync handles new submissions in real time  
✅ Existing subscribers can be bulk-synced with one click  
✅ Phone numbers flow into Mailchimp merge fields when collected  
✅ Your email marketing lists stay up to date without manual exports 🔗

---