Skip to content
Qivra Help Center

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

Section titled “What This Integration Does”
FeatureDescription
Contact SyncAdd form submitters to Mailchimp lists
Email NotificationsSend notifications via Mailchimp
Marketing AutomationTrigger Mailchimp campaigns
Audience BuildingGrow your email list from forms

Prerequisites

Section titled “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

Section titled “Getting Mailchimp API Key”

Step 1: Log in to Mailchimp

Section titled “Step 1: Log in to Mailchimp”
  1. Go to mailchimp.com
  2. Sign in to your account

Step 2: Access API Keys

Section titled “Step 2: Access API Keys”
  1. Click your profile icon
  2. Go to Account & Billing
  3. Click Extras > API keys

Step 3: Create API Key

Section titled “Step 3: Create API Key”
  1. Click Create A Key
  2. Name it (e.g., “Qivra Form Builder”)
  3. Copy the API key

Finding Your Audience ID

Section titled “Finding Your Audience ID”

Step 1: Go to Audiences

Section titled “Step 1: Go to Audiences”
  1. In Mailchimp, click Audience
  2. Click All contacts

Step 2: Select Audience

Section titled “Step 2: Select Audience”
  1. Choose the audience you want to use
  2. Click Settings > Audience name and defaults

Step 3: Copy Audience ID

Section titled “Step 3: Copy Audience ID”

The Audience ID looks like: a1b2c3d4e5

Configuring Mailchimp in Qivra Form Builder

Section titled “Configuring Mailchimp in Qivra Form Builder”

Step 1: Open Settings

Section titled “Step 1: Open Settings”
  1. Go to Qivra Form Builder
  2. Click Settings in sidebar
  3. Go to Providers section

Step 2: Select Mailchimp

Section titled “Step 2: Select Mailchimp”
  1. Find Mailchimp in the provider list
  2. Click to select it

Step 3: Enter Credentials

Section titled “Step 3: Enter Credentials”
FieldDescription
API KeyYour Mailchimp API key
Server PrefixAuto-detected from API key (e.g., us1)

Step 4: Select Audience

Section titled “Step 4: Select Audience”
  1. After saving API key
  2. Select your Audience from dropdown
  3. Map form fields to Mailchimp fields

Step 5: Field Mapping

Section titled “Step 5: Field Mapping”

Map your form fields to Mailchimp merge fields:

Form FieldMailchimp Field
Email*EMAIL (required)
First Name*FNAME
Last Name*LNAME
PhonePHONE
CompanyCOMPANY

Step 6: Save Settings

Section titled “Step 6: Save Settings”
  1. Click Save
  2. Test the connection

Using Mailchimp for Notifications

Section titled “Using Mailchimp for Notifications”

Email Notifications via Mailchimp

Section titled “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

Section titled “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

Section titled “Form-Level Settings”

Per-Form Audience

Section titled “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

Section titled “Opt-In Settings”

Control how contacts are added:

SettingDescription
Single Opt-InAdded immediately
Double Opt-InConfirmation email sent
Update ExistingUpdate if contact exists

Tagging Contacts

Section titled “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

Section titled “Sync Behavior”

When Contacts Sync

Section titled “When Contacts Sync”

Contacts are added to Mailchimp when:

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

Field Updates

Section titled “Field Updates”

If contact already exists:

SettingBehavior
Update existingUpdates fields with new data
Skip existingKeeps original data
ErrorFails if duplicate

Testing the Integration

Section titled “Testing the Integration”

Test Submission

Section titled “Test Submission”
  1. Submit a test form
  2. Check Mailchimp audience
  3. Verify contact appears

Check Field Mapping

Section titled “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

Section titled “Mailchimp Features You Can Use”

Groups

Section titled “Groups”

Organize contacts into groups:

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

Segments

Section titled “Segments”

Create segments based on form data:

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

Automation Triggers

Section titled “Automation Triggers”

Trigger email sequences:

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

Troubleshooting

Section titled “Troubleshooting”

Contacts Not Syncing

Section titled “Contacts Not Syncing”
CauseSolution
Invalid API keyVerify and re-enter key
Wrong audienceCheck audience selection
Missing emailEnsure form has email field
Rate limitsCheck Mailchimp plan limits

Field Mapping Issues

Section titled “Field Mapping Issues”
IssueSolution
Field not syncingCheck mapping is correct
Wrong dataVerify field types match
Missing fieldsAdd merge fields in Mailchimp

API Errors

Section titled “API Errors”
ErrorMeaning
401 UnauthorizedInvalid API key
404 Not FoundWrong audience ID
429 Rate LimitedToo many requests

Mailchimp Pricing Considerations

Section titled “Mailchimp Pricing Considerations”

Contact Limits

Section titled “Contact Limits”
PlanContacts
Free500
Essentials50,000
Standard100,000

Email Limits

Section titled “Email Limits”

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

Best Practices

Section titled “Best Practices”

List Management

Section titled “List Management”
  • Keep audiences organized
  • Use tags for segmentation
  • Clean inactive contacts regularly

Opt-In Compliance

Section titled “Opt-In Compliance”
  • Honor unsubscribe requests
  • Include required footer info
  • Follow email regulations (GDPR, CAN-SPAM)

Data Quality

Section titled “Data Quality”
  • Validate email addresses
  • Collect necessary info only
  • Keep fields up to date

Video Tutorial

Section titled “Video Tutorial”
Play
Section titled “Related Docs”