Real People, 24/7

Mailchimp for Salesforce Setup with Features Explained

Hello there and thanks for stopping by!

Interested in understanding how to put all the Mailchimp and Salesforce integration pieces together? 

We’re here to help!

We’ve crafted this article just for subscribers like you to help you understand how SyncApps works with your Mailchimp for Salesforce.

Before starting, take a look at our basic integration setup, as explained here:

Check out some key documentation for Mailchimp with Salesforce integration:

Are you testing out how the Mailchimp Campaign marketing metrics syncs back to Salesforce with SyncApps? See the guide here:

Before setting up the integration, here are some important integration points:

  • Salesforce Classic and Lighting edition are both supported.
  • SyncApps supports all built on Salesforce AppExchange Apps. 
  • Make sure that your Salesforce account is API enabled.
  • Create a test List View(s), Campaign(s), or records for testing purposes.
  • Create a test Audience in Mailchimp (this test Audience will be specified in Step 2 of the Set Up where you want your Salesforce records to be synced)
  • Scheduling of a Set Up is available on Free Trial and Paid plans. (Step 6)

Let’s Get Started!


Setting up your Integration

Setting up your Set up (integration) is super simple!

See the video below on how to set up Mailchimp for Salesforce.

Setting up your Set Up (integration) is easy! Looking for a Quick Setup Guided Tour

You are now setting up the integration, so we are giving you an EXTRA 2 Weeks Free on us!

Enjoy 4 Full Weeks to test out all your use cases using all our features and integration capabilities. 

  • Sync 1 - 1,000,000+ records such as Contacts, Leads, and Accounts sync between Salesforce and Mailchimp
  • Sync 1 - 1,000,000+ Opt-Outs to and from Mailchimp which is automatically managed by SyncApps between Salesforce records
  • 1 or 1,000,000+ Salesforce Campaigns/Marketing List/List Views sync for Mailchimp Audience segmentation
  • Sync 1 - 1,000,000+ Campaign metrics such as opens, clicks, bounces, links clicked from Mailchimp back to Salesforce
  • Sync on Demand included for easy testing of your integration scenarios
  • Scheduling of a Set Up is available on Free Trial and Paid plans (Step 6)



Logging in to your SyncApps account will land you the SyncApps Dashboard. Head to Set Up and Once you’ve selected the Set Ups tab, tap the “Create Set Up” button.

Enter any designated name for your new Set Up as your identifier. Then in Sync Type, select Mailchimp for  Salesforce.

Step 1: Salesforce  


Salesforce Configuration

Select the preferred Authentication Type.

If "OAuth2" is selected, just tap the connect button and enter the credentials then you'll automatically be connected.

If the Username and Password option is selected, enter the Salesforce credentials together with your Salesforce security token.

Enter your Salesforce account credentials such as your username, password, and Security Token. Alternatively, you can use the Username and Password as the Authentication type, just make sure that your Salesforce account is API enabled.

A Salesforce Sandbox is a test account type that uses testing records that will not affect your live or production records when syncing. If you are testing records or requirements but want your production records unaltered, enable this option.

To use the Salesforce Sandbox, enable the checkbox first before Authenticating Salesforce in Step 1.

Select the Object type to use. You can only use 1 Object type per Set up. For example, if you’ll select Contact as the Object type, then only these types of records will be synced to/from Mailchimp.

Want to use a Campaign, List View, or Marketing List to sync Campaign and List Members to Mailchimp? Select this feature


  • Why do you need this feature? This will help you segment your Salesforce Campaign(s)/Marketing List(s) or even List View(s) into Mailchimp and may help if you target specific Mailchimp Audiences.
  • A Group or Tag will be created in Mailchimp for each Salesforce Campaign, List View (or Marketing List).
Note -- If checked only those in the Marketing List, List View, or Campaign will be synced. If this option is not checked then all Contacts or Leads will be synced directly to the specified Main Audience in Step 2 of the integration set-up.
  • If using licenses please use Cazoomi Marketing List as it only requires the standard Contact or Lead object. Try our Step 5 Filtering and Segmentation features as it works with well.
  • Are you using Person Accounts? SyncApps will know that your Salesforce instance uses Person Accounts so please select this Object Type in Step 1 to sync.
  • Not using Salesforce Campaign(s), List Views, or Marketing List(s) but need to segment your Salesforce records in Mailchimp? Use our Filtering and Segmentation Feature in Step 5 of the Set Up

Want to create a new record if an email address is updated in Salesforce instead of just updating the email record in Mailchimp? Select this feature 


  • If this use case below happens a lot on your team then you could benefit from using this feature that always creates a new record in Mailchimp instead of editing the existing email record. By default, SyncApps updates Mailchimp when you edit any Salesforce record’s email and does not create a new record in Mailchimp.


  1. A Salesforce record is entered and then synced to Mailchimp.
  2. On the next email, it hard bounces, and Mailchimp writes back to your custom “hard bounce” field in Salesforce, as TRUE.
  3. A Salesforce user sees this and notices that the likely reason it bounced is because of a typo in the email address. The user simply fixes it in Salesforce.
  4. The Sync seems to correct the email address in Mailchimp – but no new record is created and it simply uses the same record. And because this record is CLEANED (hard bounced in Mailchimp), the corrected email address can never be mailed to.
  5. Now we have a situation in Mailchimp where we have a cleaned record displaying a perfectly valid email address.

Sound familiar? Then this option is for you.

Feature Reminder: Create a new record if an email address is updated in Salesforce instead of just update the email record in Mailchimp.

Use Salesforce checkbox field(s) for Mailchimp Group segmentation


  • You can create each of your Groups (checkboxes on your Mailchimp form) as also checkboxes on the Lead or Contact record in Salesforce then set up in your Set Up to match them in Step 1.
  • Each Checkbox field must be named verbatim and spelled correctly to match existing Groups in Mailchimp.

Required additional Add-Ons, if using our Free Plan:

  • List Sync
  • Custom Field Mapping
Note -- If this option is selected then please disable the Mailchimp Tag Segmentation Option in Step 2 as this feature only works bidirectionally on Groups.

Please see the following article for more details.

Want to track the Marketing Metrics such as Opens, Clicks, Bounces back to Salesforce from your Mailchimp Campaign(s)? Select this feature 


What exactly is Sync Campaign Response?

  • Sync Campaign Responses means that we will bring back unlimited marketing metrics to CRM from your Marketing Automation solution. We can even sync only records with opens or clicks activity to allow lead nurturing in CRM as well as what they clicked on in your drip marketing campaigns. Email Marketing Campaigns are synced back to CRM every time a sync runs or 24 hours based on your sync schedule settings.
  • Need to enable the feature of Campaign Response sync for Person Accounts?
  • Check out this article here: Set up Campaign Responses for Salesforce Accounts used as Person Accounts

For more options, tap "More Options." If you want to learn more about the features, hover over to the SyncNotes tooltips.

More Options


Salesforce to Mailchimp

Don't want to sync Contact, Leads, or Accounts to your Mailchimp Audience? Select this feature


  • If wanting to sync only the new records or existing records from Mailchimp, enable this option; One-way sync. No records will be synced from Salesforce.

Want to unsubscribe Contacts, Leads, or Accounts from your Mailchimp Main Audience if a record unsubscribes/opts out in Salesforce? Select this feature 


  • If this option is enabled SyncApps will unsubscribe Contacts or Leads from Mailchimp Main Audience that are flagged as opted-out in Salesforce.
  • If the Contact or Lead Email Opt Out (HasOptedOutOfEmail) checkbox is checked in Salesforce then the email address will be unsubscribed from Mailchimp Audience.
  • If this option is not checked then opted-out Contacts, Leads, or Accounts in Salesforce are simply ignored (opt-out is not synced to Mailchimp). So what happens is that the record in Salesforce is already unsubscribed/opted out but in Mailchimp, it’s still subscribed/opted-in yet will not be updated anymore every time the sync runs.

Need to remove the Contact, Lead, or Account record(s) from your Mailchimp Main Audience if the record(s) is deleted in Salesforce? Select this feature 


  • If a Contact, Lead, or Account is deleted in Salesforce, SyncApps will remove the email address from your Mailchimp Main Group.
  • Need to remove the record on a matching Audience when using Salesforce Campaign(s), List Views, or Marketing List(s) sync feature? Grab our Full Sync Add-On now! How does Full Sync work?

Check out this video on How Full Sync Add-On Works:

Are you Converting Leads in Salesforce into Person Accounts / Contact type and want that Lead record to be removed in Mailchimp? Select this feature 


  • If this option is checked when a Lead is converted to a Contact, the Lead email address will be removed from Mailchimp by SyncApps.
    Need to understand more about how converted Leads with SyncApps works? Check out this article here: How do I sync Salesforce Person Accounts to Mailchimp.
  • Do you only want to delete all previously synced Leads? Select this feature
  • When using the Delete Converted Leads feature and if using the same Main Audience, the best practice is you'll need to create a Contacts Set Up and enable this feature so that the previously synced Leads that were "Converted Leads" will be deleted in your Main Audience and they will be synced properly to your Main Audience.

Delete records with a blank email address in Mailchimp 


  • If this option is checked, when a Lead or Contact that has been previously synced is updated with a blank email address, the Contact will be removed in Mailchimp.

Need to store other email address fields in Mailchimp? Select this feature


  • By default, SyncApps will still use the standard email address field for records creation and updates. If wanting to still sync the other email address fields like work email, personal email, and other email address fields outside the standard email address field, please enable this feature then map the email address fields in Step 4 of the Set Up.
Note -- These mapped email address fields in Step 4 of the Set Up will still be treated as a text field and won't be used as a recipient for targeted Marketing Automation Campaigns.

Are you using the Namespace prefix in your Salesforce account?


  • Please input your one to 15 character namespace prefix.
Note: Please do not include the trailing 2 underscores.

Check Personal, Work, and Alternate email for new records creation from Mailchimp


  • By default, when there are new records created from your specified Main List or Main Audience, we'll check the native Email Address or Preferred email field in Salesforce first if the email address already exists. After that, we then check the non-preferred if that email address already exists, if so, then we will just not marry or connect the record.
  • If using Salesforce NPSP, please enable this feature especially for records creation to prevent duplicates to be created.

Mailchimp to Salesforce


New Subscriber Object Type 


  • Please select which Salesforce Object Type to be created when there is a new subscriber in Mailchimp.
  • If no Object Type is selected then SyncApps will use the above Object Type (Object Type to Sync).
Please note that by default, SyncApps will always search for the email record in Salesforce, both in Leads and Contacts, then only create a Lead or Contact if no email exists in Salesforce for both Leads or Contacts. And also, the email template from Mailchimp is attached to the Salesforce Campaign that is created by SyncApps not attached per contact.
  • On Lead creation, SyncApps will set the "Company" to "Individual" by default in Salesforce. Since SyncApps does not set the Company name from Mailchimp unless this field is mapped in Step 4 thus uses the Salesforce default ("Individual") when creating new Leads.

Create a new Contact or Lead in Salesforce even if a matching email a record exists for either


  • Enabling this will allow SyncApps to search for duplicates on the same object type only as of the "New Subscriber Object Type" and create a record.
  • Example: If a record already exists as a Contact and you select Lead as the new subscriber object type, SyncApps will ignore the duplicate and will create a new Lead.
Note -- SyncApps uses the email address to check for duplicates. Meaning no 2 records with the same email address and the same object type will be created by SyncApps.

Do not create a new Account if Contact's company name cannot be found in Salesforce


  • By default, SyncApps will create a new Account if the company name does not exist in Salesforce.

Use "Unknown" as the last name if blank, Use "Unknown" as the first name if blank


  • If syncing new Contacts / Leads from Mailchimp and the First name is blank, Salesforce will automatically reject the record to be created if you require the First Name field is a required field.
  • By default, the last name is a required field in Salesforce. So, if this field is blank, then the record will not be synced and also throw an error.  To avoid this, just enable either of these options that match your Salesforce record creation rules.


If done in Step 1 of the Set Up, hit next so that the configurations will be saved.

Step 2: Mailchimp  


Mailchimp Configuration

Connect your Mailchimp account in this step by tapping the “Connect” button. You will then be directed to the oAuth page that’ll log in to Mailchimp. Enter your Mailchimp credentials here.

Generate a new API Key, copy then paste it in the API key box in Step 2 of the Set Up.

To obtain a Mailchimp API key please log into Mailchimp, press the Top Menu: Account > Extras > Your API Keys. Create a new API Key or copy an existing API Key into SyncApps.

After which, enter the name of your Main Audience Now, what is the Main Audience, and why do we need to define it in Step 2?

A Mailchimp Audience can be selected from the dropdown of available Mailchimp Audiences. 


Note: We require to define the Main Audience because Mailchimp needs it in creating, updating, and removing records using its API.

If you would like to sync to a different Audience in Mailchimp, you'll need to set up another "Set Up" for that use case.

Campaign Response Sync Selection (Just means Marketing Metrics in laymen's terms)


  • Each Mailchimp Campaign syncs back to a Salesforce Campaign, Activity, Note, or even just metrics only for each record sent the Campaign from Mailchimp.
  • By default, SyncApps will only retrieve Campaign Responses until 30 days after the Campaign is sent. Need to retrieve Campaign Responses past the 30 day limit for Campaign Responses retrieval? Upgrade to our Enterprise Plan or you may purchase an Add-On here: Purchase Add-On

Need to use Multiple Group Categories on a Mailchimp Audience? Check it here


  • A List View, Marketing List, or Campaign must be selected in Step 1 under "Sync Campaigns or List Members to Mailchimp Groups" in order to be used in this setting for this feature.
  • To change which Group Category a List View, Marketing List, or Campaign should map to, please check the checkbox after the Mailchimp Group Category name.
  • Next, enter the Mailchimp Group Category you want to use to sync from the List View, Marketing List, or Campaign.

For more options, tap "More Options." If you want to learn more about the features, hover over to the SyncNotes tooltips.

More Options


Don't want to Sync new Mailchimp Subscribers to Salesforce? Select this feature


  • If using multiple Set Ups, which use the same “Main Audience” then out of those Set Ups, set all but 1 Set Up as One-Way Sync so that it will minimize API Calls.
  • This also means SyncApps will only sync unsubscribe data thru one Set Up which is not a One-Way Sync for efficiency since all the integrations are utilizing one Main Audience. Check this article here: I have multiple Set Ups or integrations using the same Main List or Audience

Segmentation Method 


  • Automatically creates Mailchimp Groups or Tags into your Mailchimp Audience from Salesforce List Views, Campaigns, or Marketing Lists.

“Use Groups” under the Segmentation method


  • This field is optional. For the marketing list sync feature, each Salesforce Marketing List, Campaigns, or List Views is synced to a Mailchimp Group, and new subscribers from Mailchimp will be synced to Salesforce Marketing List, Campaigns, or List Views of the same name as Mailchimp Group name.
  • By default, SyncApps will use the "My Groups" Group Category with Hidden type (not displayed in Mailchimp form). You can override the category of the Group by putting in a different Group Category.
  • To display Groups in the Mailchimp signup form please create new Groups with checkboxes type and specify the Group Category in this field.


Note: "My Groups" will automatically be created in your Mailchimp Audience by SyncApps on the first sync if you're using the Step 1 or Step 5 segmentation features. If renaming the "My Groups" Group Category in Mailchimp, you will need to also specify the new name of the Group under "Group Category to use" in Step 2 of the Set Up setup so that Syncapps will connect to it:


If you rename the "My Groups" Group Category without updating the steps mentioned above then SyncApps will recreate "My Groups" Group Category and sync to it.

“Use Tags” under the Segmentation method


“Use GDPR” under the Segmentation method


  • This allows the possibility to map any checkbox field on your Salesforce records to GDPR fields (by default, each checkbox name will need to match the GDPR field 100% or it will not sync over to Mailchimp GDPR fields). 
  • List Views, Campaigns, and Marketing Lists will also work to map to the GDPR Fields in Mailchimp.

Don't want to sync unsubscribed status to Salesforce when they unsubscribe in Mailchimp? Select this feature


  • By default, SyncApps will set opted-out status in Salesforce for unsubscribed emails. Please check this checkbox if you do not want unsubscribed emails to be synced.

Need to update Salesforce when subscribers update their Profiles in Mailchimp? Select this feature


  • This will use mapping configuration to update data from the Mailchimp Update Profile Form. Please make sure you configure the mapping correctly in Step 4 of your Set Up.
  • A webhook will be set up in the specified Mailchimp Audience by SyncApps if this option is enabled.
  • Update Salesforce on new subscription if the email address already exists in CRM 
  • If a record resubscribes on your specified Mailchimp Main Audience, it will then recheck to see the Group membership on the Mailchimp side and update any Checkboxes on the record in Salesforce.

Resubscribe archived records 


  • By default, when a Contact or Lead that was synced by SyncApps is then Archived in Mailchimp, on the next sync, that record will no longer be updated in Mailchimp. If you want them to be resubscribed and unarchive them in Mailchimp automatically so that they will be updated on the next sync, please enable this feature.
Note -- This will only work for records that are synced(cached) by SyncApps. Meaning, if they are marked as archive prior to the sync and SyncApps hasn’t initially synced(cached) the records to Mailchimp, those will not be updated.
If done in Step 2 of the Set Up, hit next so that the configurations will be saved.

Step 3: Add-Ons  


Sync Add-Ons are optional. Available Add-Ons in Step 3 of the Set Up may depend on which Plan and integration you select. In our Enterprise Plan, you don't need to enable anything here as all these features are included.

Want to know which Sync Add-On fits your requirement? Give us a shout today!

Check out this video on How Add-Ons Works:

Step 4: Field Mapping  


Field Mapping is optional. Basic fields such as Email address, First Name, and Last Name are already pre-mapped even if you haven’t enabled this Step. Otherwise, if you have more additional fields to map, then you’ll have to set these fields up here.

Generic Field Mapping Guide

Update mailing address fields to and from Mailchimp

Check out this video on How Field Mapping Works:

Step 5: Filtering and Segmentation  


This Step is one of the most powerful features ever used by most of our subscribers. Like for example, you have 1000’s of records in your CRM then you only want to pull out the records with specific criteria, only these records will be synced to your Mailchimp Main List.

See here for more information on how it works.

Filtering and Segmentation Guide

Check out this video on How Filtering and Segmentation Works:

Step 6: Scheduling  


Finally, the very last step. Just select the time when you would like to sync your data automatically.

Sync Scheduling Guide

Check out this video on How Scheduling Works:

Tap the "Finish" button and then Sync Now. 

Need some help?


Check out the options below on how you can contact our support team and find the answers you need to help you with your SyncApps integrations.

Help Center & Email is 24/7 to | Live Chat & Phone is scheduled  


Check out these Help Desk articles for answers to frequently asked questions.

Get Started | Login Issues | Pricing

Check out our subscriber's story here on how SyncApps helped them save hundreds of hours per year!



Have more questions? Submit a request