Skip to main content

Mailchimp integration

Connect Somiti to Mailchimp and your newsletter audience follows your member list: people who join are added, name and email changes are copied over, and people whose account becomes inactive or suspended are unsubscribed. It only goes one way. Changes you make in Mailchimp don’t come back to Somiti.

Only admins can set it up, from Settings, Integrations tab.

The Configuration card on a Mailchimp connection's page: the API key hidden as dots, the audience ID, Yes for both sync options, and the default tag Riverside Member.
  1. Your API key is masked as dots on this page.
  2. The Mailchimp audience members go into.
  3. Tags Somiti asks Mailchimp to add to each member it sends.

Connect Mailchimp

You need two things from Mailchimp: an API key and your audience ID.

Get your API key:

  1. In Mailchimp, click your profile picture and go to Account & billing, then Extras, then API keys.
  2. Click Create A Key, give it a name like “Somiti” and copy the key. It ends with a dash and a short code like -us21. Somiti needs that ending to know where your account lives.

Get your audience ID:

  1. In Mailchimp, go to Audience, then All contacts.
  2. Open Settings and choose Audience name and defaults.
  3. Copy the Audience ID.

Connect in Somiti:

Tip: The API key works like a password. Don’t paste it into an ordinary email or chat. Create a key just for Somiti, so you can disable it in Mailchimp and make a new one if it’s ever exposed.

  1. Go to Settings, click the Integrations tab, and click Connect on the Mailchimp card.
  2. Give it a Name, like “Newsletter”.
  3. Paste your API Key and Audience ID.
  4. Leave Sync new members automatically and Sync member updates checked.
  5. In Default Tags, add any tags you’d like on every member, separated by commas (for example Member, 2026).
  6. Under Event Triggers, check When a new member joins, When a member profile is updated and When a member status changes. These are what make the sync happen.
  7. Click Create Integration.
  8. Click Test on the page that opens. You should see “Connection successful! Found list:” and your audience’s name.

To stop sending new members, uncheck Sync new members automatically. To stop sending profile changes, uncheck Sync member updates. Status changes are always sent while When a member status changes is checked.

What Somiti sends, and when

Trigger When it happens What Mailchimp gets
When a new member joins Any new account in your community: someone who signs up, someone you add or import, and guests who register for a public event The email, first name and last name. New contacts are added as subscribed. Someone already in your audience keeps their current status.
When a member profile is updated Their name, email or phone changes The same details again. A new email is added as a new contact; the old address stays in your audience.
When a member status changes Their account becomes Active, Inactive or Suspended Active subscribes them; Inactive or Suspended unsubscribes them.

Somiti splits the name at the first space: the first word becomes the first name and the rest becomes the last name. It doesn’t send phone numbers, tiers, join dates or anything else. If you need those in Mailchimp, use Export Members on the Analytics page and import the file in Mailchimp.

A status change only works for someone who’s already in your audience. If they aren’t, Mailchimp refuses it, and the error shows on the connection’s page.

Note: Somiti sends your Default Tags with each member, but Mailchimp may not add tags to contacts sent this way. If the tags don’t show up on your contacts, tag them in Mailchimp instead, for example with a segment of everyone in the audience.

Send everyone to Mailchimp at once

Use Full Sync after you first connect, or any time your audience seems out of date.

  1. Go to Settings, click the Integrations tab, and click View on the Mailchimp card.
  2. Click Full Sync.
  3. Click OK when asked “Sync all active members to Mailchimp?”

Somiti sends every account with an Active status, one at a time, while you wait. That includes admins and managers. When it’s done you’ll see “Synced” with how many went through and how many failed. Nobody is removed from your audience, and anyone who unsubscribed in Mailchimp stays unsubscribed.

Check that it’s working

The connection’s page shows Status, Messages Sent (how many updates went through) and Last Triggered. Messages Sent also counts updates Somiti skipped because Sync new members automatically or Sync member updates is unchecked. If an update fails, a red Last Error box shows the reason Mailchimp gave. It goes away the next time Somiti sends a member update. Test and Full Sync don’t clear it.

Somiti doesn’t retry a failed update. Run Full Sync to catch up. The Last Error box stays after a Full Sync, so check the “Synced” message to see whether it worked.

Disconnect Mailchimp

  1. Open the Mailchimp connection’s page.
  2. Click Delete and click OK to confirm.

Somiti stops sending updates straight away. Nobody is removed from your Mailchimp audience.

To pause instead, click Edit, uncheck Active and click Update Integration. Somiti keeps the settings, so you can check Active again later.

Troubleshooting

The test fails.

  • Check you copied the whole API key, including the ending like -us21. Without it, Somiti won’t save the key.
  • Check the audience ID belongs to the same Mailchimp account as the key.
  • Check the key hasn’t been disabled in Mailchimp.

New members aren’t showing up in Mailchimp.

  • Check Status on the connection’s page says Active.
  • Check When a new member joins is listed under Triggers.
  • Look at the Last Error box, then run Full Sync. The box stays until the next member update goes through, so go by the “Synced” message instead.

One member won’t sync.

  • Check their email address on the member list. Mailchimp rejects addresses it thinks are fake or mistyped.
  • If they unsubscribed from your newsletter themselves, Mailchimp won’t let Somiti subscribe them again. They need to sign up again through a Mailchimp form.