The Mailchimp integration automatically adds form submitters to your Mailchimp email list every time someone submits a form. This eliminates the manual process of exporting CSV files and importing them into Mailchimp. It is essential for lead generation forms, newsletter signups, event registrations, and any form where you want to follow up with email marketing.
Every form submission that includes an email address is a potential subscriber. The Mailchimp integration ensures that potential is captured automatically, without you lifting a finger after the initial setup.
What You Need Before Starting
- A Mailchimp account (free or paid plan)
- At least one Audience (email list) already created in Mailchimp
- Your Mailchimp API key
Setup Walkthrough
Step 1 — Get Your Mailchimp API Key- Log in to Mailchimp at mailchimp.com.
- Click your profile icon in the bottom-left corner and go to Account & Billing.
- Navigate to Extras > API Keys.
- Click Create a Key. A new API key is generated.
- Copy the key immediately (you will not be able to see it again after leaving the page).
- In WordPress, go to Form Forge > Settings > Mailchimp.
- Click Connect.
- Paste your Mailchimp API key into the field.
- Click Save. Form Forge verifies the connection and shows a “Connected” status. Your API key is stored securely on the Forge API server, not in your WordPress database.
- Open the form you want to connect (or create a new one).
- Go to the form’s Integrations settings tab.
- Toggle on Mailchimp.
- Select the Audience (List) you want to subscribe people to from the dropdown.
- Map the Email field — select which form field contains the subscriber’s email address. The dropdown only lists fields whose type is Email, so add an Email field first if the dropdown is empty.
- Optionally, map other fields to Mailchimp merge fields. For example, map your form’s Name field to Mailchimp’s FNAME (First Name) and LNAME (Last Name) merge fields.
- Save the form.
How It Works
- Every time someone submits the form, their email (and any mapped fields) are sent to Mailchimp.
- If the person is already on your list, their information is updated. No duplicate subscribers are created.
- New subscribers are added with a “subscribed” status immediately.
- The form submission is also saved in Form Forge as usual. The Mailchimp sync is an additional, automatic action.
- If Mailchimp rejects the request, the visitor still gets the normal success state and Form Forge records a diagnostic entry for support instead of losing the submission.
Troubleshooting Mailchimp
| Problem | Most likely cause | Solution |
|---|---|---|
| Subscribers not appearing in Mailchimp | Email field mapping is incorrect | Check that the correct form field is mapped to Mailchimp’s email |
| “API key invalid” error | Key was regenerated or revoked in Mailchimp | Create a new API key in Mailchimp and reconnect in Form Forge |
| Merge fields not populating | Field mapping does not match Mailchimp merge tags | Verify merge tag names in Mailchimp under Audience > Settings > Merge Tags |
| Wrong audience receiving subscribers | Wrong audience selected in form settings | Edit the form’s Integrations tab and select the correct audience |
| Subscriber shows as “cleaned” | Mailchimp previously removed this email (bounced or unsubscribed) | The subscriber needs to re-subscribe directly through Mailchimp |
| The Email field dropdown is empty | The form does not have an Email field type yet | Add an Email field to the form, save, and return to the Mailchimp mapping |
| Submission is saved but the diagnostic log says “Invalid request” | The integration request was rejected before Mailchimp received it | Update to the current Forge API build; empty merge-field maps are normalized and the subscriber hash is generated server-side from the lowercase email |
> Tip: Test the integration by submitting the form with your own email address. Check Mailchimp to confirm the subscriber appeared in the correct audience with the correct merge field values (first name, last name, etc.).
> Good to know: Without PRO, the Mailchimp integration is not available. You can export submissions to CSV (free) and manually import them into Mailchimp, but this requires manual effort each time.
Common Mistakes to Avoid
- Forgetting to create a Mailchimp Audience before connecting. You need at least one audience for the integration to work.
- Not mapping merge fields beyond email. Sending just an email to Mailchimp means you cannot personalize your emails with the subscriber’s name.
- Connecting Mailchimp in Settings but forgetting to enable it on the specific form. Both steps are required.
[Screenshot: The form Integrations tab showing the Mailchimp toggle turned on, an Audience dropdown, and field mapping rows linking form fields to Mailchimp merge fields]
—