Updating Donorfy from Mailchimp

You can link Mailchimp to Donorfy so that when someone...

  • Subscribes to a Mailchimp audience (formerly list), or
  • Changes their preferences in Mailchimp, or 
  • Unsubscribes from a Mailchimp audience 

... the Details in Donorfy are updated - the updates in Donorfy can be as follows:

  • When someone subscribes to a Mailchimp audience
    • Add a new constituent in Donorfy if they do not already exist
    • Allow email communications channel
    • Allow communication purposes and/or add tags  
  • When someone updates their preferences in Mailchimp
    • Allow or block communication purposes 
    • Add or remove tags  
  • When someone unsubscribes from a Mailchimp audience
    • Block communication purposes 
    • Remove tags  

PLEASE NOTE: adding or removing a Tag to or from a Mailchimp subsciber does not automatically update Donorfy. This is because the Mailchimp webhook is not triggered under these conditions.

Setting Up the Link between Mailchimp and Donorfy 

Donorfy purposes & tags can be added or removed based on Mailchimp groups and tags - the mapping for this needs to be set up for Mailchimp to update Donorfy - see this article for more information.

Find your Donorfy API key - see this knowledge base article for help with that.

The next thing you need to do is set some things up in Mailchimp, you can update Donorfy from a Mailchimp audience you can use a new or existing Mailchimp audience for this.

  • Log in to Mailchimp with your admin account.
  • Find the existing Mailchimp audience you want to use (or create a new one).

You need to create a webhook so Mailchimp can send changes to Donorfy

  • Click on the Mailchimp Settings Menu - choose the webhooks option 
  • Press the Create New Webhook button
  • In the field CallbackURL enter the Donorfy webhook URL followed by your Donorfy API key  i.e. https://api.donorfy.com/api/MC/YourDonorfyAPIKey  your entry may look like https://api.donorfy.com/api/MC/ABCDEFG - see this knowledge base article
  • You need all updates except 'Campaign sending' 

  • Make sure you are not sending updates made via the API  - i.e. don't tick the 'via the API' box

  • Save your changes

What the Link will do

When a someone subscribes, updates their profile or unsubscribes from a Mailchimp audience the link will

  • Try and find an existing Donorfy constituent with the email address of the subscriber, if
    • One constituent has that email address that constituent will be updated
    • If no constituents have that email a new constituent will be added for subscribes otherwise the update will be ignored
    • If more that one constituent has that email address it will be added to the 'To be resolved list' see below
  • The constituent will be updated as follows
    • For new subscribes and profile updates, the link will
      • make sure the email channel is open 
      • ensure that communication purposes are allowed as per the mapping between Donorfy and the Mailchimp audience
      • tags are added as per the mapping between Donorfy and the Mailchimp audience
    • For unsubscribes,
      • Any communication purposes mapped to the Mailchimp audience are blocked
      • Any tags mapped to the Mailchimp audience are removed
      • The status of the email channel is not changed - i.e. it is not blocked 
    • A history item will be added to the preference centre for the purposes and channel updates
    • An activity will be added to the constituent's timeline

Note that if you use an existing Mailchimp audience details of existing subscribers will not be automatically loaded into Donorfy - to do that you will need to export the Mailchimp audience and upload into Donorfy using the File Uploader.

To be Resolved List

There are some circumstances where Donorfy needs your help to decide what happens when a conflict arises - these typically are when an email address sent by Mailchimp to Donorfy matches more than one constituent in Donorfy. 

These cases show up in Donorfy Data Management | Mailchimp Sync page. Each case requiring resolution is shown with options for you to use to resolve the situation. 

History of Updates

You can see the updates that have happened by clicking on the Mailchimp Sync option under Data Management and looking on the history tab

Testing the Link 

To check the link is working as you expect you can add a test subscriber to your Mailchimp audience - setting Mailchimp groups and tags - the details will be sent through to your Donorfy - note that Donorfy queues up requests so it may take a few seconds for the updates to come through.

You can update the groups and tags of your test subscriber in Mailchimp - the mapped Donorfy purposes and tags will be updated.

If you unsubscribe your test subscriber the purposes and tags mapped to the Donorfy constituent will be removed. 



Have more questions? Submit a request


Powered by Zendesk