Setup Mailchimp Integration

Mailchimp is a popular email marketing platform. This guide shows you how to integrate Mailchimp with Qivra Form Builder to sync contacts and send notifications.

What This Integration Does

Feature	Description
Contact Sync	Add form submitters to Mailchimp lists
Email Notifications	Send notifications via Mailchimp
Marketing Automation	Trigger Mailchimp campaigns
Audience Building	Grow your email list from forms

Prerequisites

Before setting up Mailchimp:

1. Have a Mailchimp account
2. Know which Audience/List to use
3. Have API key ready

Getting Mailchimp API Key

To begin, you’ll need an API key from your Mailchimp account:

1. Log in to your Mailchimp account
2. Navigate to Account > Extras > API Keys
3. Click Create A Key
4. Copy the generated key for use

Reference: https://help.klaviyo.com/hc/en-us/articles/115005062267-Manage-Your-Account-s-API-Keys

Finding Your Audience ID

Step 1: Go to Audiences

1. In Mailchimp, click Audience
2. Click three dots > Audience settings

Step 2: Copy Audience ID

The Audience ID looks like: a1b2c3d4e5

Reference: https://mailchimp.com/fr/help/find-audience-id/

Configuring Mailchimp in Qivra Form Builder

Step 1: Open Settings

1. Go to Qivra Form Builder
2. Click Settings in sidebar
3. Go to Third party integration section

Step 2: Add Mailchimp API key and Audience ID to the app settings

1. Find Mailchimp in the provider list
2. Click to select it
3. Paste the API key and audience ID you just created.

4. Click Test and save

Step 3: Select Mailchimp list

1. Open the app > click Forms > open the form you want to deal with
2. Click Integration on the settings > turn on Mailchimp option

Step 4: Map Form Fields to Mailchimp Fields

• The Email value is compulsory here to create a new profile in Mailchimp
• The other values are optional. Please map them based on your needs

For example: the First name field of Mailchimp is matched with First name field of the form, the Last name field of Mailchimp is matched with Last name field of the form.

Step 5: Save Settings & Test Your Form

1. Click Done
2. If the form is already published, you just need to save the form after making changes.

How It Works

After a user submits the form, the form sends data to Mailchimp.

• Mailchimp creates or updates the subscriber profile.
• Log in to your Mailchimp account > go to Audience > All contacts.
• Open the list you integrated with your form > check for the new subscriber profile to confirm data has been added successfully.

Submission detail in the form app:

New contact is added to Mailchimp audience list:

Using Mailchimp for Notifications

Email Notifications via Mailchimp

To send notification emails through Mailchimp:

1. In Settings > Providers
2. Select Mailchimp as email provider
3. Configure notification settings

Transactional Email Setup

Mailchimp offers transactional email (formerly Mandrill):

1. Set up transactional email in Mailchimp
2. Use SMTP settings in Qivra
3. Or use Mailchimp API for sending

Form-Level Settings

Per-Form Audience

Use different audiences for different forms:

1. Open form in Form Builder
2. Go to Settings > Integrations
3. Select Mailchimp audience

Opt-In Settings

Control how contacts are added:

Setting	Description
Single Opt-In	Added immediately
Double Opt-In	Confirmation email sent
Update Existing	Update if contact exists

Tagging Contacts

Add tags to organize contacts:

1. In form integration settings
2. Add tags to apply to contacts
3. Tags help segment your audience

Example Tags:

• “Contact Form”
• “Newsletter Signup”
• “Product Inquiry”

Sync Behavior

When Contacts Sync

Contacts are added to Mailchimp when:

• Form is submitted successfully
• Email field is present
• Integration is enabled

Field Updates

If contact already exists:

Setting	Behavior
Update existing	Updates fields with new data
Skip existing	Keeps original data
Error	Fails if duplicate

Testing the Integration

Test Submission

1. Submit a test form
2. Check Mailchimp audience
3. Verify contact appears

Check Field Mapping

1. Review contact details in Mailchimp
2. Ensure all fields mapped correctly
3. Check tags are applied

Mailchimp Features You Can Use

Groups

Organize contacts into groups:

1. Create groups in Mailchimp
2. Map form fields to groups
3. Contacts are grouped automatically

Segments

Create segments based on form data:

1. Use tags from forms
2. Create segments in Mailchimp
3. Target specific audiences

Automation Triggers

Trigger email sequences:

1. Set up automation in Mailchimp
2. Trigger on tag or group
3. Form submissions start sequences

Troubleshooting

Contacts Not Syncing

Cause	Solution
Invalid API key	Verify and re-enter key
Wrong audience	Check audience selection
Missing email	Ensure form has email field
Rate limits	Check Mailchimp plan limits

Field Mapping Issues

Issue	Solution
Field not syncing	Check mapping is correct
Wrong data	Verify field types match
Missing fields	Add merge fields in Mailchimp

API Errors

Error	Meaning
401 Unauthorized	Invalid API key
404 Not Found	Wrong audience ID
429 Rate Limited	Too many requests

Mailchimp Pricing Considerations

Contact Limits

Plan	Contacts
Free	500
Essentials	50,000
Standard	100,000

Email Limits

Free plan includes 1,000 emails/month. Check your plan for limits.

Best Practices

List Management

• Keep audiences organized
• Use tags for segmentation
• Clean inactive contacts regularly

Opt-In Compliance

• Honor unsubscribe requests
• Include required footer info
• Follow email regulations (GDPR, CAN-SPAM)

Data Quality

• Validate email addresses
• Collect necessary info only
• Keep fields up to date

Video Tutorial

Play

Related Docs

• Email Notification Settings
• Setup Klaviyo
• Field Types Reference