Latest ReleaseCurrent VersionIncluded in WHMCS

MailChimp® is an email marketing and automation platform. It is free to use for up to 2,000 subscribers and allows up to 12,000 emails per month.

The WHMCS MailChimp integration uses MailChimp’s e-commerce API to synchronize customer, order, and abandoned cart data with your MailChimp account. This allows you to use MailChimp to set up manual and automated campaigns.

This includes:

  • Thank you messages to new customers.
  • Automated followup messages on abandoned carts.
  • Onboarding or drip-feed campaigns to new customers.
  • Attempts to recapture lapsed customers who haven’t bought anything recently.
  • Rewards for your best customers (based on order count or total spent).


Because this addon ships with WHMCS by default, you only need to create a Mailchimp account and activate the addon through the Admin Area.

To do this:

  1. If you do not yet have a MailChimp account, create one for free.
  2. Go to Configuration () > System Settings > Addon Modules.
  3. Click Activate for MailChimp.
  4. Click Configure.
  5. Select the admin role groups that will have access to this addon.
  6. Click Save Changes.
  7. Log in to MailChimp.
  8. Click the icon next to your name at the bottom left of the page.
  9. Select Account & billing.
  10. Select Extras > API keys.
    Going to Extras > API keys in MailChimp.
  11. Click Create A Key.
  12. Copy the key to your clipboard. We also recommend giving the API key a label in your MailChimp account (API Key for WHMCS in the example below).
    Copying the API key in MailChimp.
  13. Go to Addons > MailChimp.
  14. Enter the API key in WHMCS. You will see this screen the first time you access the MailChimp addon after activating it.
    Entering the MailChimp API key in WHMCS.
  15. Follow the instructions to finish the setup process.

Creating an Automated Campaign

To create an automated campaign:

  1. Log in to your MailChimp account.
  2. Go to Create > Automations.
  3. Click Get Started.
  4. Click Check out Classic Automations.
  5. Choose E-Commerce.
  6. Select your desired email from the list of premade options or click Custom to create a new campaign using advanced mode. For example, to create an onboarding automation for new customers:
    1. Select Follow up on purchases. This option sends email after an applicable purchase according to your settings.
    2. Select Product category. This option only sends email for purchases of specific types of product.
  7. Enter a name for your new automation (in this example, Follow up on SSL purchase).
  8. Choose the mailing list that you connected with your WHMCS installation. The campaign overview will appear.
  9. Click Edit next to the trigger to choose the applicable product category.
  10. Click Save.
  11. Design your campaign’s emails. You must create at least one.

Working with Customers

New Customers

New customers will be added to MailChimp with their opted in or out status according to their marketing email selection during account creation (via the registration page or when placing their first order).

Importing Existing Customers

The MailChimp WHMCS integration will track customer signups and e-commerce transactions immediately after activation. To add your preexisting customers to your MailChimp mailing list, you can perform an import.

To do this:

  1. Go to Reports > Reports in the WHMCS Admin Area and click More.
  2. Under Exports, click Clients.
  3. Select the data to export. We recommend exporting First Name, Last Name, Company Name, and Email Address.
  4. Click Filter to generate the report.
  5. In the top-right corner, click Tools and choose Export to CSV. This allows you to download a list of your customers in the CSV format.
  6. Go to MailChimp.
  7. Go to Lists and choose the list you want to import customers to.
  8. Go to Add contacts > Import contacts.
  9. Choose the CSV or tab-delimited text file option.
  10. Click Next.
  11. Follow the displayed instructions to upload the CSV export and complete the import process.

Change Log


Last modified: June 5, 2024