Skip to main content

Mailchimp IntegrationPro

This documentation page assumes you have read over the Email Marketing Integration Overview. If you have not yet read it, please do so now. We also assume that you have a Mailchimp account already, along with mailing list(s) already created. This integration requires that you have Freeform Pro. If you currently have Freeform Lite, you can purchase an upgrade to Freeform Pro.

Video: Setting up a Mailchimp integration

​Compatibility

Mailchimp integration includes support for field mapping to standard and custom fields of the following types:

​Additional Features

The Mailchimp email marketing integration also allows support for Contact Tags, individual Interests/Groups and GDPR consent / Marketing settings.

  • To map Contact Tags, in the Tags field mapping area in the form builder for the form, select a Freeform field that will contain Tag value(s). This could be a select dropdown, a checkbox group, radio field, hidden field, etc. When specifying multiples, separate by comma.
    • By default, the Mailchimp integration will replace/overwrite any existing Contact Tags if it finds an existing contact for the email address in Mailchimp. If you'd like it to append/add to the existing Contact Tags instead, enable the Append Mailchimp Contact Tags on update instead of overwriting? setting inside the integration settings.4.0.24+
  • To map a Contact Interest/Group, in the Group or Interest field mapping area in the form builder for the form, select a Freeform field that will contain an Interest/Group name value(s). This could be a select dropdown, a checkbox group, radio field, hidden field, etc.
    • Values are case-sensitive and should be entered exactly as it is in Mailchimp, e.g. My Group Name.
    • It can accept more than one group.4.1.4+
  • To map GDPR consent / Marketing settings options, in the GDPR field mapping area in the form builder for the form, select the Freeform field(s) which will represent opting into the corresponding options. ANY value included in these will be considered an opt-in (regardless of whether it's yes or y, etc). You will need to map a field to each GDPR setting individually, so you'll likely need to use a separate checkbox field for each.

​Setup Instructions

1

​Create & get API Key from Mailchimp

  • Open a new tab and go to Mailchimp website and log into your account.
  • Click on your account avatar at bottom left corner and choose Account & Billing.
  • On the next page, select the Extras > API keys sub navigation option.
  • Click the Create New Key button at the bottom of the page.
  • After the page reloads, copy the newly created key under the API key column.
2

​Set up Integration on your site

  • Go to the Email Marketing section in Freeform Settings (Freeform > Settings > Email Marketing).
  • Click the New Email Marketing Integration at the top right.
  • Select Mailchimp from the Service Provider select dropdown.
  • Enter a name and handle for the integration.
  • Paste the Mailchimp API key into the API Key field in Freeform.
  • At the top right corner of Freeform page, click Save button.
3

​Verify Authorization

  • After the integration is saved, it'll return you to the list of mailing list integrations.
  • Click into the newly created integration.
  • Confirm that there is green circle with Authorized in the middle of the page.
Finished!
Page Feedback