Skip to main content
Mailchimp is written, not read. Your people go out to one Mailchimp audience on a schedule. Their audience is something you fill, not a person record you want back. Only an organization admin can set it up or change it, under Settings → Advanced & security → Integrations.

What it does

First name and last name go as FNAME and LNAME, and each person’s roles here go as tags: Adopter, Donor, Volunteer, Foster and Pantry client, a household your pet food pantry serves. Build a segment in Mailchimp on a tag to write to just those people: a new resource for people low on funds to your Pantry client tag, say, or a foster appeal to Foster. One thing does come back: anybody who unsubscribes in Mailchimp is added to your suppression list here on the next send.

What you need

  • A Mailchimp API key. Their key carries its own data center in its suffix, so there is nothing else to discover and no app to install.
  • Your Audience ID. In Mailchimp, open Audience, then Settings, then Audience name and defaults. It is listed there, and looks like a1b2c3d4e5.
  • To be an Organization admin in RescueConsole.

Setting it up

1

Get a key from Mailchimp

In Mailchimp, open your Account, then Extras, then API keys, and create one.
2

Add the integration

In RescueConsole, open Settings → Advanced & security → Integrations, find Mailchimp under CRM and email marketing, and add it.
3

Enter the key and the audience

Paste the API key and press Save it. The key is stored and never shown again. Type the Audience ID under Your Mailchimp Audience ID and press Save the ID.
4

Test the connection

Test the connection names the audience it reached and how many people are in it.
5

Decide on permission to email

Under Permission to email, the box is unticked unless you tick it, and Mailchimp emails each new person to ask them to confirm. Tick it only if the people you are about to send have given your organization permission to email them: they are then added as subscribed, without being asked. Read it: it is your obligation, not ours.
6

Turn people on, going out

Under Which way choose Out, tick People under What to sync, choose How often, and Save.

What moves

The tags follow the roles on every send. A role added here is tagged there, and a role taken away comes off. A tag of the same name that somebody added by hand in Mailchimp is managed the same way, so keep your own tags under other names. Tagging does not start your Mailchimp automations. Everybody with an email address goes, unless they have opted out of your communications, have Marketing mail (Mailchimp) turned off on their record, said No to Mailchimp when they signed an adoption contract or a foster agreement (Sharing their details), or their address is on your suppression list. Somebody who said No after they were sent is archived in your audience on the next send, once.
Unless Permission to email was ticked, Mailchimp emails each new person to ask them to confirm, and only the ones who agree are subscribed. That is their doing, not ours, and it is why a send of two hundred people does not become two hundred subscribers.
Sends go at most hourly. Each one works through your people a page at a time and brings unsubscribes back, and Mailchimp allows only ten simultaneous connections. An hour is plenty for an audience.

When it goes wrong

Test the connection answers Connection failed with the reason:
  • Mailchimp refused the API key.
  • That does not look like a Mailchimp API key: theirs end with their data center, such as -us14.
  • Mailchimp does not have an audience with that ID. Check the Audience ID under Settings, Integrations.
A send that fails is shown under Mailchimp on the Integrations page, in Mailchimp’s words where they gave any, and it tries again on its own, waiting longer after each failed try (never more than a day), until a send works.