Mailchimp Salesforce integration connects your email marketing platform with your CRM so contacts, campaign activity, and engagement data sync automatically, no manual exports or field remapping required.

Mailchimp Salesforce integration guide

Since May 2024, Mailchimp retired its legacy Salesforce connector and handed the official integration to Beaufort 12. If you're setting up fresh, you're working with a different app than most older guides describe. If you're on the legacy version, you need to know what still works.

This guide covers the current state of the integration, how to set it up step by step, common limitations, and when a Salesforce-native alternative makes more sense.

Ways to Integrate Mailchimp with Salesforce

You can connect Mailchimp with Salesforce in three ways. Your choices are the official AppExchange app, a custom API build, or a third-party tool like Zapier.

Mailchimp for Salesforce App (via AppExchange)

This is the most common route. Since May 2024, Beaufort 12 has built and maintains the official connector. It starts at $25/month per Salesforce org.

The app syncs contacts and leads between Salesforce and Mailchimp in both directions. It also includes a data wizard for building audiences from Salesforce reports, list views, or SOQL queries. On top of that, field mapping, campaign tracking, and audience analytics all work inside Salesforce dashboards.

If you set up the legacy free connector before May 2024, it still runs. However, Mailchimp no longer ships updates for it. All new installs now go through Beaufort 12.

Native API Integration

Some teams need tighter control than the AppExchange app allows. In those cases, you can connect the two platforms directly through their APIs.

This path gives you full control over what data syncs, when it syncs, and in what direction. The tradeoff is that you need developer resources to build and maintain it. Most teams choose this route only when they have complex automation or custom objects that the standard app cannot support.

Third-Party Automation Tools

Platforms like Zapier and Workato connect Mailchimp and Salesforce through pre-built triggers and actions. For example, you can sync new Salesforce leads to a Mailchimp audience automatically.

These tools suit teams without engineering support who need basic sync. They're quick to set up and require no code. The downside is they add another vendor, another subscription, and another moving part to monitor.

How to Set Up Mailchimp for Salesforce: Step-by-Step

The setup takes about 30 minutes and follows three stages: install and connect, map your fields, and configure permissions. Installation is straightforward. The real work is in the configuration choices that follow.

Step 1: Install and Connect

Go to the Salesforce AppExchange and search for "Mailchimp for Salesforce" by Beaufort 12. Install the app, open it from the App Launcher, and authorize your Mailchimp account through OAuth. Beaufort 12's setup documentation walks through each screen with screenshots.

Two things to note before moving on. Unlike the legacy app, Beaufort 12 supports multi-audience sync. And installation in a sandbox first is recommended so you can test before going live in production.

Step 2: Field Mapping and Sync Configuration

This is where most teams make mistakes. Either they skip mapping altogether, or they sync every field they can find. Both create problems down the line.

Open the Field Mapping section within your audience settings. Map Salesforce fields to their Mailchimp equivalents. Start with high-impact fields only:

  • First Name / Last Name
  • Email Address
  • Subscription Status
  • Tags or Interests
  • Lead Source

Skip low-value fields like freeform notes or company size. These create clutter and increase the chance of sync errors.

Next, set your overwrite rules. Decide whether Mailchimp should update Salesforce fields on every sync or only at first creation. For most teams, Salesforce should stay the source of truth for core contact data. That means Mailchimp writes to Salesforce only for engagement data and subscription changes.

Then configure your sync frequency. You can choose from preset intervals or set a custom schedule. The app also supports manual syncs for one-off needs.

Before going live, test with a small group of contacts. Confirm that the right records land in Mailchimp with correct tags and segments. Fix mapping issues now, not after a full sync pushes bad data into your audience.

Step 3: Permissions and Page Layouts

Assign permission sets to your team. Beaufort 12 includes two levels:

  • Mailchimp Standard: for viewing campaign data and audience info
  • Mailchimp Admin: for configuring sync, managing field mapping, and editing integrations

You can assign these from the User Security Settings page inside the Mailchimp app directly.

Then add the Mailchimp Lightning Components to your Lead and Contact page layouts. These components surface audience membership, campaign history, andemail engagement metrics right on the record. Sales reps see exactly how contacts interact with marketing emails without switching platforms.

If you use Salesforce Campaigns, link your Mailchimp campaigns to Salesforce campaigns as well. This lets you track performance inside Salesforce reports and dashboards.

Common Limitations and Sync Issues

The Mailchimp-Salesforce integration has five key limitations: sync delays between platforms, API call consumption on every sync cycle, duplicate record creation from mismatched emails, no support for custom objects, and unsubscribe sync gaps that create compliance risk. Some of these are manageable with the right settings. Others are structural gaps that no configuration can fix.

Sync delays, API consumption, and duplicates are the most commonly cited. You can reduce their impact by syncing fewer fields, lowering sync frequency, and using Salesforce's Duplicate Management Rules. These are well-documented in Beaufort 12's support guides.

The less obvious limitations cause the real problems.

Custom Object Gaps

The standard connector syncs Contacts and Leads only. If your team emails records on custom objects like Opportunities or Cases, the integration can't reach them.

Workarounds exist. You can use Flows or formula fields to copy data from custom objects to standard ones. But both add complexity, and both need ongoing maintenance as your data model changes.

Unsubscribe Sync Risks

When someone unsubscribes in Mailchimp, that change should sync back to Salesforce and update theEmail Opt Out field. In practice, there's a delay between the unsubscribe and the field update.

During that window, Salesforce still shows the contact as opted in. A rep could send an email to someone who already opted out. That's a compliance risk under CAN-SPAM and GDPR, and it's one the integration's design doesn't fully prevent.

When Records Stop Syncing

Start with field mapping. Misaligned or missing required fields are the most common cause. Check that Salesforce validation rules aren't silently rejecting incoming data from Mailchimp.

For missing engagement data, confirm that your sync settings explicitly include activity data. Opens, clicks, and bounces won't appear in Salesforce unless you turned them on during setup.

Mailchimp Salesforce Integration Best Practices

Five habits keep the Mailchimp-Salesforce integration running smoothly after setup: quarterly field audits, engagement dashboards, sync log checks, Flow-based automation, and a clear data ownership rule.

1. Audit Field Mappings Quarterly

Review your field mappings every quarter and remove any that are outdated or unused. Teams add, rename, and retire Salesforce fields all the time, so mappings fall behind quickly. When that happens, syncs break without warning. A 15-minute review each quarter saves hours of debugging later.

2. Build Engagement Dashboards in Salesforce

Create Salesforce reports that show your sales team how contacts engage with Mailchimp campaigns. Start with three questions:

  • Which leads opened the last three campaigns?
  • Which CTAs got the most clicks?
  • Which campaigns had high unsubscribes or bounces?

Then share these as dashboards with reps. Reps who seecampaign performance data act on it, while reps who don't tend to ignore marketing signals entirely.

3. Check Sync Logs Weekly

Open the Sync Logs tab in Salesforce at least once a week, especially during the first month. Look for failed records, missing fields, and API limit warnings. Most sync failures don't send alerts, so the only way to spot them is by checking the logs yourself.

4. Use Flow Builder for Automation

Set up automation rules in Salesforce Flow Builder to act on the data Mailchimp pushes in. The integration moves data between the two platforms, but it doesn't trigger actions on its own. So if you want an alert when a lead opens three emails in a week, for example, you'd build that logic in Flow Builder.

5. Pick One System as the Data Owner

Decide early which system owns which data. Salesforce usually owns contact details like name, title, and company, while Mailchimp usually owns engagement data like opens and clicks. Without this rule, both systems end up overwriting each other, and fields go blank, or records go stale. Write the rule down and share it with your team so everyone knows which platform to trust.

Mailchimp Salesforce Integration: Next Steps

If you're going ahead with the integration, start small. Install Beaufort 12's app from AppExchange, map only the essential fields, and test with a handful of contacts before opening the full sync. Set Salesforce as the data owner for contact attributes from day one, so both systems aren't fighting over the same fields. Then check your sync logs weekly for the first month to catch issues early.

For teams that need more, though, the integration may not be enough. If you send emails from custom objects or need engagement data in real time, aSalesforce-native email platform skips the sync layer entirely.

MassMailer runs 100% inside Salesforce. It sends from any standard or custom object, so you're not limited to Contacts and Leads. Engagement data like opens, clicks, and bounces shows up on the record instantly, with no sync delay. Unsubscribes update in real time too, which closes the compliance gap that the Mailchimp connector leaves open.

On top of that, MassMailer bypasses Salesforce's daily email sending limits, so you can scale campaigns without hitting caps. And because everything stays inside your CRM, there's no API consumption, no field mapping to maintain, and no second platform to manage.

Start your free trial today!