Connect Mailchimp

Mailchimp is integrated with Halaxy to quickly send out bulk email campaigns, newsletters, and promotions to patients. All you need is a Mailchimp account.


You can also use Halaxy's native Campaigns feature to send out bulk email or SMS messages.

Connect your Mailchimp account to Halaxy

When you integrate your Mailchimp account, your patient list syncs as an audience in Mailchimp. All patients with an email address are included in the sync, regardless of patient status. You can open the sync list in Halaxy to view additional details, including patient status and preferred name.

To integrate Halaxy with Mailchimp, follow the steps below.

  1. Open your Mailchimp profile. At the top, click Extras > API Keys.

  2. Under API Keys, click Create a Key.

  3. An API key is generated and ready to use. Copy this API key.

  4. Sign into Halaxy and click Settings > Integrations.

  5. Under the Marketing section, next to Mailchimp, click the Icon-Edit.svg edit icon.

  6. In the pop-up, for the API Key, paste the API key you copied.

  7. Tick the Enabled checkbox and fill in the rest of the form.

  8. Click Submit.

Your Mailchimp account is now integrated with your Halaxy account. Your patient list at the group level is created as an audience in Mailchimp.


Please allow some time for your audience to sync with your patient list. Depending on the size of your patient list, this may take several hours.

Frequently Asked Questions

Click the question to view the answer:

I tried to integrate my Mailchimp account, but I keep getting an error 403 - user action not permitted. What does this mean?

You will receive this error if you have a free plan or have a restriction on the number of audience lists in your Mailchimp account.

When Halaxy integrates with Mailchimp, it will add a new audience to the user's account. Accounts on the free Mailchimp plan may only contain a single audience, so when a user on a free plan attempts to create a new audience in the Mailchimp application, they will be prompted to upgrade to a plan that can accommodate this. However, when this is attempted over the API, this error will be generated.

If you receive this error, you can:

  • remove the audience list(s) that you have currently added to Mailchimp and then re-integrate your accounts using the steps above;

  • update the audience list that you have currently added in Mailchimp manually;

  • upgrade your Mailchimp plan;

  • use Halaxy's Campaigns feature to send out bulk email/SMS messages instead

Halaxy Campaigns allow you to send out newsletters, updates, promotions etc. in bulk to an unlimited number of users, as frequently as you would like with no restrictions. You can include your own content, and email campaigns are free (SMS campaigns cost credits in line with SMS reminders).

For more information on campaigns, check out our blog article or support guide article.

Can I export my Patient List to Mailchimp?

Your Patient List is automatically synced at the group level when you integrate Mailchimp with Halaxy. You can also manually export your patient list by clicking Patients > Patient List and then clicking the Export icon in the top-right of the page. You can then manually add these email addresses to your Mailchimp audience list.

How will I know if a patient's details have been automatically synced to Mailchimp?

You can check the syncing status of your Patient List by running a patient report and setting the report type to Mailchimp in Halaxy.

Why is my Mailchimp audience smaller than expected?

Only patients with an email address in Halaxy are synced. Ensure that your patients have email addresses, then try again. You may need to delete or recreate the audience in Mailchimp and integrate Mailchimp and Halaxy again.

When I run a Mailchimp sync report, it says "The requested resource could not be found". What does this mean?

You will receive this error if your Halaxy mailing list/audience in Mailchimp is deleted or lost. To fix this error, you will need to resync your Halaxy and Mailchimp accounts to recreate your mailing list/audience.

To resync your accounts:

  1. Click Settings > Integrations.

  2. Click the Edit icon next to Mailchimp.

  3. Copy the API Key (CTRL+C) and then delete it, then click Submit.

  4. Click the Edit icon next to Mailchimp again.

  5. Paste the API Key (CTRL+V) back into the API Key field, then click Submit.

RESULT: Halaxy will re-establish the connection with Mailchimp and re-export your patient list to Mailchimp.


Was this article helpful?