The Mailchimp add-on needs to be installed and activated to see the features mentioned in this documentation.

Getting your Mailchimp API Key

  1. Click this link to navigate to the API Keys section of your Mailchimp account: Your API Keys
  2. Copy an existing API key or click the Create A Key button.
    Getting Mailchimp API Key
  3. Your new key is in the textbox (highlighted yellow in the image). It includes the country code at the end. e.g. “476025ba25fd1884cc6dd3a5f1fbfe04-us11”

Setting up Ninja Forms to work with Mailchimp

  1. Go to Ninja Forms > Settings. Scroll to the bottom of the Settings page and you should see the Mailchimp section.
  2. Copy your API key from MailChimp exactly and paste into the Mailchimp settings in Ninja Forms.Mailchimp API Key

Adding a Mailchimp action to your form

  1. In the form editor, click the “Email and Actions” tab.
    Email and Actions tab
  2. Click on the blue and white plus (+) button on the bottom right of the builder and then Choose Mailchimp
    Select the MailChimp Action
  3. Choose the Mailchimp list you would like the data to be saved to.
    Note: If your lists do not show up, you may need to refresh the list via the icon beside the “List” label.
    MailChimp settings in Ninja Forms
  4. Map the fields from your form to the appropriate Mailchimp list fields using the merge tags.
    Select Merge Tags
  5. Choose your Interest groups for your list, if any.
    Interest Groups
  6. Under Advanced, Choose if you would like users to confirm their subscription.
    Have users Confirm their submission
    If this option is enabled, they will be sent an email from Mailchimp to confirm their addition to the list.

Please note that if a field is required in Mailchimp, it MUST be mapped to a Ninja Forms field, or your contact will not be added to the list.

Mailchimp Opt-in field

The Mailchimp Opt-in field gives the user an option to choose if they want to be added to a Mailchimp list without the need to setup a Conditional Logic statement.
To add a Mailchimp Opt-in field to your form, click on the blue add field button, then choose the Mailchimp Opt-in.


If the Mailchimp Opt-in field is checked, the Mailchimp Action will be processed and the user will be added to the list. If the Opt-in is unchecked, the Mailchimp Action will be ignored.