Sync Contacts to Mailchimp
Learn how to sync Contacts to Mailchimp in Topo, including aPI key.
When to use this
Use this article when you need to sync Contacts to Mailchimp in Topo. The main staff surface is Staff > Account > Mailchimp. It is written for Owners, Managers, Marketing.
What this covers
API key
Server prefix
Audience ID
Mapping Topo contacts
Master enable/disable
Test connection
Sync status
Webhook secret
Before you start
Use a staff role that can manage organization integrations.
Have the Mailchimp API key, server prefix, and audience/list ID ready.
Decide whether Topo or Mailchimp owns each campaign before enabling sync.
Save credentials before testing the connection.
Generate webhook secrets only when you are ready to copy them into Mailchimp.
Steps
Open Account > Mailchimp.
Enter API key, server prefix, and audience/list ID.
Save settings before testing.
Use Test connection and fix any credential or audience errors.
Enable or disable sync intentionally.
Generate and copy webhook secret only when configuring Mailchimp webhooks; Topo will not show it again after generation.
What happens after saving or completing this
Topo updates the related audience, message, form, referral, promotion, or conversation record.
Email sends and automations respect subscription status, category preferences, and sender readiness.
Review recipient, submission, or conversation history after the workflow completes.
Common issues and fixes
Save credentials before testing.
If the connection fails, check server prefix and audience/list ID first.
Do not run the same campaign in both Topo and Mailchimp without deciding which system owns it.
Bulk send is disabled: verify sender-domain setup and confirm the environment allows real marketing sends.
Recipients are skipped: check subscription status, category preferences, selected lists, selected segments, and whether the audience has subscribed recipients.
AI or automation content looks wrong: update the source Help Docs, templates, or sequence steps, then review the draft before sending.
Related articles
Marketing Contacts Overview
Build a Segment
Configure Email Delivery