Skip to main content
Documentation/Forms/Actions & Integrations/MailChimp Integration

MailChimp Integration

The MailChimp action sends form field values to MailChimp.

Create an API Key

  1. In Mailchimp, open your Profile, then Extras > API keys.
  2. Click Create A Key, give it a name such as Breakdance forms, and click Generate Key.
  3. Use Copy Key to Clipboard before clicking Done. The full key is shown only when it is created. See Mailchimp’s API key guide.

Save the Shared Key

  1. In WordPress, open Breakdance > Settings > API Keys.
  2. Paste the key into MailChimp API Key and click Save Changes.
Breakdance API Keys settings showing MailChimp API Key with its value concealed
Breakdance API Keys settings showing MailChimp API Key with its value concealed

Choose Default in the form to use this key, or Custom to enter a key for that form only.

Connect the Form

  1. Add the required form fields, including Email, then select MailChimp under Actions > Actions After Submission in the Content tab.
  2. Configure Use MailChimp API Key. Default uses site credentials; Custom uses credentials for this form. After correcting an invalid key, click Reload Key.
  3. Select the destination and map its fields to Form Field values, then save. Labels do not map automatically; destination choices depend on the connected account.

MailChimp Settings

Use MailChimp API Key, Audience, Double Opt-In, Field Mapping > Fields (Mailchimp Field → Form Field), and Audience Groups > Category / Group. Select the audience first. Double opt-in creates a pending subscription requiring confirmation.

MailChimp connection and destination selection before an account is connected
MailChimp connection and destination selection before an account is connected

Enable Run Action Conditionally and add Conditions to run this action only when all configured field comparisons match.