Skip to content

Mailchimp integration

Add or update the person who submitted your form in a Mailchimp audience. This is a Pro and Agency feature. Free accounts can use it on their first 50 submissions.

  1. In Mailchimp, open your profile, then Extras → API keys
  2. Create a key and copy it

The key ends with your data center, like -us21. Formkove uses that part to reach your account.

  1. Open app.formkove.com and select your form
  2. Go to Integrations and click Connect Mailchimp
  3. Paste the API key and click Continue
  4. Pick the audience
  5. Map the fields (see below)
  6. Tick Ask new contacts to confirm if you want double opt-in
  7. Optionally add a label and routing rules, then click Connect Mailchimp

The key is stored encrypted and is never shown again.

Email address is required. Map it to the form field that holds the email, usually email. Then pick what goes in each merge field, like First name or Phone:

  • A form field from your recent submissions, or Other field… to type a field name
  • A Formkove value: Submitted at, Submission ID, Form name, Sentiment, Tags, Spam score or File links
  • A fixed value that is the same for every contact
  • Don’t send, to leave it empty

Address merge fields can’t be mapped yet. Dates are sent as YYYY-MM-DD and birthdays as MM/DD. Dropdown and radio values must match one of the field’s choices.

  • A new address is added as subscribed. With double opt-in it’s added as pending, and Mailchimp emails a confirmation link
  • An address already in the audience is updated with the new merge field values and keeps its status, so people who unsubscribed stay unsubscribed
  • A submission without a valid email address isn’t sent. The delivery history says so
  • Spam isn’t sent to Mailchimp

Only add people who agreed to hear from you. A consent checkbox in your form plus a routing rule on that field sends only the people who ticked it.

Send test checks that the key can reach the audience. It doesn’t add a contact.

Problem Fix
Contacts don’t show up Check the connection is enabled and has no routing rule that filters it out, then look at Integrations → Delivery history
“Mailchimp rejected the API key” The key was deleted. Create a new one, delete the connection and connect again
“This address unsubscribed before” Mailchimp won’t re-add someone who unsubscribed. They can sign up again through a Mailchimp form
“This address was permanently deleted” Mailchimp doesn’t allow adding it again through the API
“Mailchimp refused the contact” The email looked fake to Mailchimp, or a value doesn’t fit its merge field. Check the mapping

Deleting the connection keeps the audience and its contacts. To revoke Formkove’s access, delete the API key in Mailchimp.