Getting Started

Building Blocks

Subscription Features




Billing Features


Payment Methods

Direct Debit Payments

Configuring Gateways

Fraud Management

Hosted Pages

Attach Additional Data


Open Source Resources

Other Features

API Integration

Third Party Integrations


MailChimp lets you send newsletters and targeted email campaigns to your subscriber list.

With Chargebee, you can automatically synchronize your subscription contacts to MailChimp. Once synchronized, you can send customized campaigns to your customers by applying specific filters in the MailChimp Lists.

Integrating MailChimp with Chargebee 

Having a MailChimp account would be a basic prerequisite to set up MailChimp with Chargebee.
Sign up for an account here .

Follow the steps below integrate your MailChimp account with Chargebee.

Step 1 : Link your MailChimp API key

To find the key, log in to your MailChimp account, click your profile name, navigate to AccountExtrasAPI keys.


Click Create a Key to generate a new API key or just select and copy an existing key.


Once you've copied the key, log in to your Chargebee web interface, and go to SettingsThird Party IntegrationMailChimp. Paste the API key and click Connect as shown below:


Step 2 : Choose a list to synchronize

A list in MailChimp is a collection of all the email IDs of your subscribers.
Once your MailChimp account is connected, you will be able to see all your lists from MailChimp. You can then choose a specific list that needs to be synchronized, as shown below:


After you select your list and click Sync, the other lists will be removed and only the selected list will appear in Chargebee.

MailChimp Synchronization 

After authenticating your MailChimp account and specifying the contact list to be synchronized, Chargebee automatically synchronizes your contact information every six hours. However, if you would want to manually push over some changes you've made before sending a MailChimp campaign, select a list and click on the Sync button as shown below.


Synchronization Parameters

The following details are synchronized from your subscriber list in Chargebee to MailChimp:

  • Email Address

  • First Name

  • Last Name

  • Subscription handle

  • Plan Code

  • Plan Name

  • Subscription CreatedAt

  • Subscription Status

  • In Trial Status

  • Trial End Date

  • Cancellation Reason

Chargebee automatically creates additional fields (only the ones above) required to synchronize data to MailChimp if they are not already available in MailChimp.


The synchronization is only one way at present i.e. from Chargebee to MailChimp. Hence if you make changes to subscriber's information in your MailChimp account, ensure you do the same in Chargebee as well.

Segmentation in MailChimp 

Segmentation in MailChimp lets you send newsletters to specific people.

Say, the information to be sent to your product's paid subscribers might be different from the information that has to be sent to your product's trial users. Segmenting lets you achieve the same.

As a MailChimp user, you'll need to segment your list to include only paying customers if you want your content sent just to them. You can do this easily by segmenting your list by specifying the criteria as "Subscription Status" › "is" › "Active". By segmenting this way, you'll include all paying subscribers.


When someone's payment fails or they choose to cancel their payment plan, they will not be removed from the list. Instead, their status will be updated.


Use that specific list to create your campaigns in MailChimp. You can then create multiple campaigns and send customized promotions or message to different segments of customers.


  • Currently, Chargebee can sync only to one list in your MailChimp account.
  • Chargebee can fetch only the most recent 25 of the lists available in MailChimp.
  • If a customer has two subscriptions and the same email address is used for both the subscriptions, the details of the latest subscription are added to the contact list.
  • Synchronization is subscription based. Customers without subscriptions aren't synced.