Mailchimp Integration

Automatically add form submitters to your Mailchimp email list when someone fills out your form.

Field Mapping

email

email_address(required)

name

FNAME(merge tag)

last_name

LNAME(merge tag)

Prerequisites

A Mailchimp account with at least one audience (list)
A Mailchimp API key
Your Audience / List ID
A form field that captures the subscriber's email address

Email field is required

Mailchimp requires an email address for every subscriber. By default, Flowqen looks for a form field named email. If your form uses a different field name (like subscriber_email or contact_email), change the Email field name setting to match.

Setup

Get your Mailchimp API key

Log in to Mailchimp, then go to Account → Extras → API Keys. Click "Create A Key" and copy the generated key. The part after the dash (e.g., us1) is your datacenter — Flowqen uses this automatically.

Mailchimp API Key format

xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx-us1

Find your Audience / List ID

In Mailchimp, go to Audience → Settings→ Audience name and defaults. Your Audience ID is shown on that page (e.g., abc1234def).

Configure in Flowqen

Go to your form's Settings tab, then Integrations. Scroll down to the Mailchimp section and:

Toggle "Enable Mailchimp integration" on
Paste your API Key
Paste your Audience / List ID
Set the email field name (defaults to "email")

Mailchimp integration settings panel in Flowqen

Save and test

Click Save Settings, then submit a test form entry with a real email address. Check your Mailchimp audience to confirm the email was added.

Payload

POSThttps://{dc}.api.mailchimp.com/3.0/lists/{list_id}/members

Mailchimp Lists/Members API

{
  "email_address": "jane@example.com",
  "status": "subscribed",
  "merge_fields": {
    "FNAME": "Jane",
    "LNAME": "Smith"
  }
}

Good to know

If someone is already subscribed, Mailchimp silently ignores the duplicate — no errors.
Subscribers are added with "subscribed" status (no double opt-in from Flowqen's side).
The Mailchimp API call is fire-and-forget — it never blocks or delays the form submission.
Your API key is stored securely and never exposed to form submitters.
If your form doesn't have name fields, merge tags are left empty — the subscriber is still added.