> ## Documentation Index
> Fetch the complete documentation index at: https://zuperinc-section23.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Mailchimp

The Mailchimp integration with Zuper enables users to automatically build and update a customer mailing list in Mailchimp using customer information from the Zuper platform. This integration streamlines marketing campaign execution by syncing customer data uni-directionally from Zuper to Mailchimp.

## **Prerequisites**

* Ensure you have API keys from Stripe App and Zuper app.

## Installing Mailchimp in Zuper

Follow these steps to connect your Mailchimp account with Zuper:

1. Log in to your Zuper account. Click your profile picture in the top-right corner and select **App Store**.

<img src="https://mintcdn.com/zuperinc-section23/dPOYyfraKkKVT81b/images/ZH1.png?fit=max&auto=format&n=dPOYyfraKkKVT81b&q=85&s=65ba36272dbae6b92c5149c50075f46b" alt="ZH1 Pn" width="1920" height="878" data-path="images/ZH1.png" />

2. Under the “**Browse by Category**,” select the “**Marketing & Survey**” option and choose “**Mailchimp**.”

<img src="https://mintcdn.com/zuperinc-section23/0LScPGUm2ROwokmI/images/Mail2.png?fit=max&auto=format&n=0LScPGUm2ROwokmI&q=85&s=b411e9d8cdf9afc91ddda49e89af057e" alt="Mail2 Pn" width="1920" height="878" data-path="images/Mail2.png" />

3. Click the “**Install Mailchimp**” button.

<img src="https://mintcdn.com/zuperinc-section23/0LScPGUm2ROwokmI/images/Mail3.png?fit=max&auto=format&n=0LScPGUm2ROwokmI&q=85&s=a5b17a89751028102bbde49fbb3725e6" alt="Mail3 Pn" width="1920" height="878" data-path="images/Mail3.png" />

4. Open a new browser tab and log in to your Mailchimp account.

   Collect the following information:

* **Mailchimp API Key**:
  * Navigate to **Account & Billing** > **Extras** > **API Keys**.
  * Copy your API key. If none exists, click **Create A Key** to generate one.

<img src="https://mintcdn.com/zuperinc-section23/0LScPGUm2ROwokmI/images/Mail4.png?fit=max&auto=format&n=0LScPGUm2ROwokmI&q=85&s=e0cb4617e889ab3187f2776d3d9c4f4d" alt="Mail4 Pn" width="1919" height="928" data-path="images/Mail4.png" />

* **Audience ID**:
  * Navigate to **Audience** > **Settings**.
  * Copy the **Audience ID** from the settings page.

<img src="https://mintcdn.com/zuperinc-section23/0LScPGUm2ROwokmI/images/Mail5.png?fit=max&auto=format&n=0LScPGUm2ROwokmI&q=85&s=0372dac2fb326cda2188c4283bc13ed7" alt="Mail5 Pn" width="1919" height="919" data-path="images/Mail5.png" />

* **Server Prefix**:
  * From your Mailchimp browser URL (e.g., [https://us87.admin.mailchimp.com/](https://us87.admin.mailchimp.com/)), copy the server prefix (Here us87 is the prefix).

<img src="https://mintcdn.com/zuperinc-section23/0LScPGUm2ROwokmI/images/Mail6.png?fit=max&auto=format&n=0LScPGUm2ROwokmI&q=85&s=4a1c40084c57a07e2a0574466711d535" alt="Mail6 Pn" width="943" height="54" data-path="images/Mail6.png" />

**Note**: Keep both Zuper and Mailchimp tabs open to switch between them during setup.

5. In Zuper’s Mailchimp integration settings, enter the following:

* **Mailchimp API Key** (Mandatory): Paste the API key from step 4.
* **Audience List** (Mandatory): Paste the Audience ID from step 4.
* **Server Prefix** (Mandatory): Paste the server prefix from step 4.
* **Zuper API Key** (Mandatory): Enter your Zuper API key. Refer to [How to Generate a Zuper API Key](https://docs.zuper.co/Settings/Developer_Hub/API_Keys#api-keys) for guidance.

<img src="https://mintcdn.com/zuperinc-section23/0LScPGUm2ROwokmI/images/Mail7.png?fit=max&auto=format&n=0LScPGUm2ROwokmI&q=85&s=9fc67083bdd40637821a919cae428e82" alt="Mail7 Pn" width="1921" height="924" data-path="images/Mail7.png" />

Click **Update** to complete the integration.

## How the Zuper-Mailchimp Integration Works

The integration automatically syncs customer data from Zuper to Mailchimp, creating or updating audience records for marketing campaigns.

1. **Customer Data Sync**:

* When a new customer is created or an existing customer is edited in Zuper, their information is synced to Mailchimp as an audience member.

<Frame>
  - **Navigation in Zuper**: *Customers > New Customer or Edit Customer.*
</Frame>

<Warning>
  **Important**: The customer’s email address is mandatory in Zuper for syncing to Mailchimp. If the email is missing during customer creation, it must be added later. Editing an email in Zuper creates a new audience member in Mailchimp, rather than updating the existing one.
</Warning>

2. **Viewing Synced Data in Mailchimp**:

* In Mailchimp, navigate to **Audience** > **Manage Contacts**.
* View the synced customer data (from Zuper) listed as an audience member in Mailchimp.

<img src="https://mintcdn.com/zuperinc-section23/0LScPGUm2ROwokmI/images/Mail10.png?fit=max&auto=format&n=0LScPGUm2ROwokmI&q=85&s=dc47be0ac2f3e88a92c4f24a2ad65d37" alt="Mail10 Pn" width="1917" height="924" data-path="images/Mail10.png" />

* Click an email address to view detailed profile information under **Profile Information**.

<img src="https://mintcdn.com/zuperinc-section23/0LScPGUm2ROwokmI/images/Mail11.png?fit=max&auto=format&n=0LScPGUm2ROwokmI&q=85&s=4bb79f68a427359b97cafabf0cf6c1ae" alt="Mail11 Pn" width="1918" height="926" data-path="images/Mail11.png" />

## Uninstalling Mailchimp for Zuper

1. Log in to your Zuper account. Click your profile picture in the top-right corner and select **App Store**.

<img src="https://mintcdn.com/zuperinc-section23/dPOYyfraKkKVT81b/images/ZH1.png?fit=max&auto=format&n=dPOYyfraKkKVT81b&q=85&s=65ba36272dbae6b92c5149c50075f46b" alt="ZH1 Pn" width="1920" height="878" data-path="images/ZH1.png" />

2. Under the “**Browse by Category**,” select the “**Marketing & Survey**” option and choose “**Mailchimp**.”

<img src="https://mintcdn.com/zuperinc-section23/0LScPGUm2ROwokmI/images/Mail2.png?fit=max&auto=format&n=0LScPGUm2ROwokmI&q=85&s=b411e9d8cdf9afc91ddda49e89af057e" alt="Mail2 Pn" width="1920" height="878" data-path="images/Mail2.png" />

3. Click "**Uninstall App**."

<img src="https://mintcdn.com/zuperinc-section23/0LScPGUm2ROwokmI/images/Mail12.png?fit=max&auto=format&n=0LScPGUm2ROwokmI&q=85&s=f692f88606247cd16ed3188277c9832c" alt="Mail12 Pn" width="1920" height="878" data-path="images/Mail12.png" />

4. The Mailchimp app will be uninstalled successfully.

<img src="https://mintcdn.com/zuperinc-section23/0LScPGUm2ROwokmI/images/Mail13.png?fit=max&auto=format&n=0LScPGUm2ROwokmI&q=85&s=67869f8a81590287a474911aa128f917" alt="Mail13 Pn" width="1920" height="878" data-path="images/Mail13.png" />

For marketing campaigns, email IDs and customer details are essential. With the unidirectional Zuper to Mailchimp data flow, you can add your audience list to Mailchimp. The database will sync and get automatically updated every time new customers are created on Zuper. 
