This article highlights some common troubleshooting options to use with our Mailchimp integration. This article touches primarily on reasons why contacts may not be in sync between the two applications, and your Kindful Group totals do not match the Tag totals in Mailchimp.
For any troubleshooting issues, check the following items:
- Make sure Kindful is still authorized in Mailchimp.
- Make sure Mailchimp is still connected in Kindful.
- The integration will only work when it is connected by an Owner or Admin of Mailchimp, and the connected user remains at that access level.
- Make sure the Audience List(s) that are synced with Kindful haven't been deleted. If an Audience List is deleted in Mailchimp, there's no way for Kindful to know about it, so in Kindful it will look like the sync just stopped working.
Kindful is only able to sync contacts to Mailchimp:
- have a valid email address
- (person with) email address has not unsubscribed
- email address is not subject to a compliance issue with Mailchimp
- email address has not bounced
If any contact is in Kindful with the following:
- email deliverable marked "no" in Kindful
- unsubscribed to the Audience in Mailchimp
- email address has bounced from Mailchimp
- is subjected to a compliance review by Mailchimp
... then Kindful cannot sync the contact to the Mailchimp Audience.
Why a Contact May Not Sync
- The contact doesn't have all the required fields filled out (First name, Last name, email address).
- The contact has opted out of mailings in Mailchimp directly, or via response to an email sent using Mailchimp (check the details on contact record in Kindful and/or in Mailchimp)
- The contact is in a Mailchimp Audience that is not mapped to Kindful. Go to Apps > App Directory > Mailchimp > Edit Configuration to resolve.
- The integration wasn't set up properly. Go to Apps > App Directory > Mailchimp to resolve.
- The integration wasn't mapped properly. Go to Apps > App Directory > Mailchimp > Edit Configuration to resolve.
- Mailchimp is requiring fields that are blocking the contact from syncing. In your Mailchimp settings, make sure to remove all required fields other than the email address to resolve.
- It is possible that you have more contacts in your Kindful Group than appear as contacts in the connected email marketing provider. To get a better understanding of why this might be, you can identify which of your Kindful Contacts are Email Solicitable (and able to be synced). To find this number, head to the individual Group page by clicking on the Group name link from your Contacts > Groups page in Kindful. Hover your mouse over the number below the "Total Members" section. Doing so will make the "Email Solicitable" number appear.
Why a Kindful Group May Not Sync
The group existed before the integration was setup. You will need to recreate the group in Kindful to kick off the sync. Be sure you delete the group that existed previously for cleanliness in your Kindful account.
Syncing Mailing Addresses
Kindful will only sync a mailing address to/from the Kindful address fields to the Mailchimp address fields. We do not support syncing a Kindful mailing address field to a Mailchimp custom text field for address.
Why a Custom Field May Not Sync
The custom field was added after the initial mapping. You will need to remap the integration to include the newly added custom field to the syncing.
Go to Apps > App Directory > Mailchimp > Edit Configuration to resolve.
See the Status of Your Integration and Syncs
If you go to Apps > App Directory > Mailchimp > Edit Configuration, you will find your Mailchimp Audience Lists with the Contact Count, Newest Member, and the Added date and time of that member.
Find Out What Will Sync / What is Synced with Mailchimp
When you view your groups by clicking on the "Groups" button on the left menu in Kindful, you will see a "Refresh from Mailchimp" option in the Actions button next to the groups that are currently connected with Mailchimp. To add additional groups to the sync, simply add or remove a contact from the group you want to sync.
Number of Contacts in Kindful Group Doesn't Match That in Mailchimp
- Not all of your contacts have email addresses.
- Not all of your contacts have First or Last names.
- You might have 2 or more contacts with the same email address. Mailchimp will only import one of the contacts.
To see how many of your contacts in a given group are solicitable, navigate to the Groups page and hover your cursor over the number in the people section. It will say “[x] Email Solicitable”.
See a Kindful Group in Mailchimp
If you look at your list of Contacts in Mailchimp, you will see the Groups represented as Tags in the line of the contact record.
See a Mailchimp Tag in Kindful
A Mailchimp tag will appear on the Groups page in Kindful. In order to get the tag to sync to Kindful, the contact must be a part of an Audience List that is in sync with your Kindful + Mailchimp integration.