Syncing your newsletter list¶
In short: Open Settings → Integrations, click the Mailchimp card, set Donor sync to On, enter your Mailchimp API key, Audience ID and Audience name, and click Save. ActiveDonor then copies your donors into that Mailchimp audience and keeps them in step. You need the Manage Settings permission. Mailchimp is the only supported provider, and the integration is marked Deprecated.
Overview¶
Newsletter sync copies the donors you keep in ActiveDonor into a Mailchimp audience (Mailchimp's word for a subscriber list), so your newsletter list stays up to date. The Mailchimp window explains: "Turning sync on copies all donors to your Mailchimp audience."
⚠️ Important: The Mailchimp integration is deprecated. The card carries a yellow Deprecated label and the window says "This integration is deprecated and will be removed soon." Existing syncs keep working for now, but plan for it to be removed.
Before you start¶
You'll need:
- The Manage Settings permission. Without it, Integrations doesn't appear in the Settings menu.
- A Mailchimp account with an API key, plus the Audience ID and Audience name of the audience you want to sync into. Find these in your Mailchimp account.
📌 Note: Mailchimp API keys end in a server-location suffix after a hyphen (for example
…-us21). ActiveDonor reads that suffix automatically, so copy the full key.
Where newsletter sync lives now¶
Newsletter sync used to be the Newsletter Sync tab under Settings → Messaging. That tab has gone. The settings now live on the Mailchimp card under Settings → Integrations. The old address (/newsletter) takes you straight there.
Turning Mailchimp sync on¶
Step 1: Open Integrations¶
In the top navigation bar, open the gear / cog dropdown and select Settings. In the left-hand Settings menu, select Integrations. The page lists your Available integrations.
Step 2: Open the Mailchimp card¶
Click the Mailchimp card ("Sync donors with your newsletter audience."). A Mailchimp window opens.
Step 3: Switch Donor sync on¶
Set Donor sync to On. The other fields become editable.
Step 4: Enter your Mailchimp details¶
- API key: your full Mailchimp API key, including the suffix after the hyphen. Once a key is saved, the box shows "Saved — leave blank to keep"; leave it blank to keep the saved key.
- Audience ID: the audience's ID in Mailchimp.
- Audience name: the exact name of that audience.
Step 5: Optionally sync project allocations¶
Tick Sync project allocations to also push project-allocation changes to Mailchimp.
Step 6: Save¶
Click Save. ActiveDonor checks your key and audience with Mailchimp. If they match, the sync turns on, a first bulk sync starts in the background, and a Done! message reads "Mailchimp settings saved." If something is wrong, the window reopens with the error at the top.
What the status means and how to tell a sync is done¶
The Mailchimp card shows a status pill:
- 🟢 On: sync is switched on and working.
- 🟡 Needs attention: sync is switched on but has stopped.
- ⚪ Off: sync is switched off.
Inside the window, a banner may also show:
- "Sync is in progress. You can change these settings tomorrow." A bulk sync started today. While this shows, the Save button is disabled. It clears the next day.
- "Sync has stopped. Check your API key and audience settings." Mailchimp no longer accepts your settings. Re-enter them and save.
💡 Tip: There's no "sync complete" pop-up. When the in-progress banner has gone, Save is clickable again and the card shows On, the bulk sync window has passed and syncing carries on in the background. Donors appear in Mailchimp as the background job works through them.
Turning sync off¶
Step 1: Switch Donor sync off¶
Open Settings → Integrations, click the Mailchimp card and set Donor sync to Off.
Step 2: Save¶
Click Save. Donor and project syncing stop and the card shows Off. You can turn it back on later.
What this does not do¶
- It does not support any newsletter provider other than Mailchimp.
- It does not give a live percentage or a "complete" pop-up. Use the card's status pill and whether Save is enabled.
- It does not sync instantly. The first run is a background bulk job and can take time on a large donor list.
Field reference¶
| Field | Required? | What to enter |
|---|---|---|
| Donor sync | Yes | On or Off |
| API key | Yes, the first time | Your full Mailchimp API key (with the suffix after the hyphen). Leave blank to keep a saved key. |
| Audience ID | Yes (when On) | The audience ID from Mailchimp |
| Audience name | Yes (when On) | The exact audience name from Mailchimp |
| Sync project allocations | No | Tick to also push project-allocation changes |
Common issues & solutions¶
| What you see | What it means | How to fix it |
|---|---|---|
| "Invalid MailChimp API key format!" | The key has no server-location suffix (the part after the hyphen). | Copy the full key from Mailchimp, including the -xxNN suffix. |
| "Invalid MailChimp API key supplied!" | Mailchimp rejected the key. | Check the key is correct and still active in your Mailchimp account. |
| "Error 404. Audience ID not found!" | The Audience ID doesn't exist in your Mailchimp account. | Re-copy the Audience ID from Mailchimp. |
| "There is no Audience named '{name}'." | The Audience ID exists, but the Audience name you typed doesn't match it. | Use the exact audience name from Mailchimp. |
| "Sync is in progress. You can change these settings tomorrow." and Save is greyed out | A bulk sync started today. | Try again tomorrow. |
| The card shows Needs attention | Sync has stopped because Mailchimp rejected the saved settings. | Open the card, re-enter your API key, Audience ID and Audience name, and save. |
| The Newsletter Sync tab is missing from Messaging | Newsletter sync moved to Settings → Integrations. | Open Settings → Integrations and click the Mailchimp card. |
FAQ¶
Where has the Newsletter Sync tab gone? It moved. Open Settings → Integrations and click the Mailchimp card.
How do I know when a sync is complete? When the "Sync is in progress" banner has gone, the Save button is clickable and the card shows On. There's no separate "done" pop-up.
Which newsletter providers are supported? Only Mailchimp, and that integration is deprecated and will be removed soon.
Do I have to re-enter my API key every time I save? No. Once a key is saved, leave the API key box blank to keep it.
How do I turn the sync off? Set Donor sync to Off in the Mailchimp window and click Save.
Related¶
- Message and email templates
- Configuring donor settings and capture forms
- Allocating receipts to projects
Need a hand?¶
If the connection keeps failing after you've re-copied your Mailchimp details, contact ActiveDonor support with the exact error you see.