Our MailChimp API allows you to sync the event's participant and volunteer data with pre-created lists in your MailChimp account. This makes it easier for your to manage your RR-inbound audiences when creating email communications out of MailChimp.
Why use this integration? With this tool, you no longer need to export your participant or volunteer list to then upload that list into MailChimp. Syncing email data periodically through the API minimizes errors, reduces privacy risks, and saves time.
Preliminary step
To access Race Roster email functionality within an event dashboard, a user needs 'MailChimp' and 'Campaigns' activated in their staff/organizer access settings for the specific event.
Configuring these options is outlined in this article: How do I change or restrict event organizer permissions?
How to enable synching
1. From your event dashboard, click on Add-ons > MailChimp from the lefthand side menu (or, enable the setting from your settings overview page).
2. Click Connect to MailChimp to connect your MailChimp account. Complete the sign-in process for this third party platform.
3. Now that you are "Successfully connected to Mailchimp" you must establish your preferences for the fields outlined below:
- User type: Choose to upload participants (whether all or only those with active or inactive registrations) or volunteers into your MailChimp list
- Sub-event(s): Select the sub-event(s) from which you want to pull data
- Mailing list: Choose to which of your existing MailChimp lists you'd like to sync the event data; if needed, click on the blue text that reads '+Create New List' and you will be sent over to MailChimp to create the list and save it; be sure to return to Race Roster and refresh the 'MailChimp' configuration page to continue
4. Review the fields you filled out and press the blue "Sync with MailChimp" button. A message will appear to notify you that the data upload could take several minutes. We've never seen it take more than 10 minutes. However, if you’re synching over 5000 records you may wish to grab a bite and a coffee while the syncing completes. Of course, keep the browser tab open while the upload completes.
Race Roster best practice:
Before synching, check the number of subscribers on the target MailChimp list and write it down. Once the sync with Race Roster is complete, head back to MailChimp and refresh the email list page to see your change in number of subscribers. If the sync is successful this number will rise.
How to disable synching
1. From your event dashboard, click on Management > Configuration from the lefthand side menu.
2. Use the search bar and type "mailchimp", selecting "mailchimp.api_key" from the dropdown menu.
3. Click the blue arrow button on the righthand side.
4. Once inside the configurations for MailChimp, clear out the content inside of the following two fields:
- mailchimp.api_key
- mailchimp.endpoint
If your plan is to connect the event to a new MailChimp account or be able to connect in the future for this event or its future duplications, you may leave the mailchimp.enabled checkbox selected as its default "On".
5. Finally, click the green "Save" button on the bottom right of the MailChimp configuration page. If you return to the MailChimp add-on settings, you will see that all synching has been removed and the page has reset to begin a new connection if needed.
Looking for more on email campaigns and MailChimp? Visit the section on Email Composer, Campaigns and MailChimp Integration.
Comments
0 comments