Introduction

Are you using Mailchimp to create, send, and analyze your campaigns?
The Vtiger-Mailchimp integration lets you sync your Mailchimp lists and associated contacts to a marketing campaign in Vtiger. Furthermore, you can sync Vtiger campaigns to Mailchimp.

The integration process requires you to:

1. Install the Mailchimp extension
2. Generate the API key
3. Sync Mailchimp data

Note: This integration supports campaign sync in one direction only - from Vtiger CRM to Mailchimp. The reverse sync, from Mailchimp to Vtiger CRM, is not supported. 

Let us look at the first step in detail.

Feature Availability

In this article, you will learn about:

• Integrating Mailchimp with Vtiger
• Generating API Key
• Synchronizing Contacts, Lists, and Campaigns
• Revoking Access

Key Terminology

Integrating Mailchimp with Vtiger

Step 1: Installing Mailchimp

You can find the Mailchimp extension in Vtiger’s Extension Store.
Follow these steps to install the Mailchimp extension:

1. Log in to CRM.

2. Click the User Menu on the top right corner of the CRM screen.
3. Select Settings.

4. Go to Extension Store.
5. Click Add-ons. The Add-ons page opens.

6. Type Mailchimp in the search bar.
7. Click Install. A 'Are you sure to install/upgrade this Add-on?' message pops-up.

8. Click Yes to confirm the installation.

A successful message will be displayed on installation.
After you install Mailchimp, you can see it under User Menu > Settings > Extensions.

The next step is to add the API key.

Step 2: Adding the API key

Adding the API key establishes a connection between Mailchimp and Vtiger CRM. 
Note: Keep the Mailchimp webpage, Vtiger tab, and a notepad open to copy and add the API key. You will have to move between these screens for this step.

Follow these steps to add the API key:

1. Log in to the CRM.
2. Click the User Menu on the top right corner of the CRM screen.
3. Select Settings.
4. Go to Extensions.

5. Type Mailchimp in the search bar.
6. Select Mail Chimp under Extensions. The Mail Chimp settings page opens.

7. Click the Add API Key.
8. Go to Mailchimp to find or generate your API key. Click here for the steps.

9. Copy the API key to a notepad. 
10. Go to the Vtiger CRM tab.

11. Paste the API Key in the Mailchimp Credentials Settings pop-up in the CRM. 
12. Click Save.

After integrating, you must create a campaign in Vtiger and link contacts to it. To learn how to do this, click here.

Step 3: Syncing data

You can sync data in three directions:

• Sync from Vtiger to Mailchimp - You can sync Vtiger contacts and campaigns to Mailchimp and run a campaign on Mailchimp. 
• Sync from Mailchimp to Vtiger - You can sync Mailchimp lists to a campaign in Vtiger. 
• Sync Both Ways - You can sync both ways mentioned above.

Let us try to understand better by taking an example.

• You create a campaign called Trade Show in Vtiger and link five contacts to it. You create a list called Trade Show Invitees in Mailchimp. You choose the Sync from Vtiger to Mailchimp option.
• When you set up the above scenario, a campaign called Trade Show is created in Mailchimp. The campaign's five contacts are added to the Trade Show Invitees list in Mailchimp. 

1. Log in to the CRM.
2. Click the User Menu on the top right of the CRM screen.
3. Select Settings.
4. Look for Extensions.
5. Click Mailchimp.
6. Choose a Mailchimp list.

7. Choose a campaign by entering the campaign name. You can also choose multiple campaigns here.
8. Choose a Sync Direction.
   1. Sync from Vtiger to Mailchimp - This syncs the campaign(s) you choose in Step 6 and its linked contacts to Mailchimp.
   2. Sync from Mailchimp to Vtiger - This syncs Mailchimp lists to the campaign(s) you choose in Step 6.
   3. Sync Both Ways - This sync lists campaigns from Mailchimp to Vtiger and vice versa.
9. Click Save.

10. Click the Main Menu.
11. Click Marketing.
12. Click Campaigns. The Campaigns page opens.

13. Click the Sync button on the top right.

14. Select Mailchimp.
15. Click Sync Log.

16. Select Mailchimp from the Extensions drop-down on the top right.

17. Click Synchronize now.

You will see the Sync Log screen that displays the number of contacts created, updated, skipped, etc., in Mailchimp and Vtiger. You can click on the number displayed to view record details.

Revoking Access

 If you no longer want to sync data between Mailchimp and Vtiger, you can revoke access to the Mailchimp account.

Follow these steps to revoke access:

1. Log in to the CRM.
2. Click the User Menu on the top right corner of the CRM screen.
3. Select Settings.
4. Got to Extensions.
5. Click Mailchimp. 

6. Click Revoke Access.

7. Click Yes to confirm. 

Revoking access removes Mailchimp credentials from the CRM but does not delete any records created via sync.