Mailchimp
Sync contacts and audiences to Mailchimp for email marketing campaigns. Keep your Mailchimp audiences in sync with your warehouse data.
Prerequisites
- A Mailchimp account
- Your Mailchimp server prefix (e.g.,
us21) - For OAuth: A Mailchimp login
- For API Key: A Mailchimp API key (format:
key-usXX)
Authentication
Mailchimp supports two authentication methods:
OAuth 2.0
- Click Connect with OAuth in SignalSmith
- Sign in to your Mailchimp account
- Authorize the connection
API Key
- In Mailchimp, go to Account > Extras > API keys
- Create a new API key
- Copy the key (format:
abc123def456-us21) - Paste it into the API Key field
The server prefix is the part after the dash (e.g., us21).
Configuration
| Field | Type | Required | Description |
|---|---|---|---|
| Server Prefix | Text | Yes | Your Mailchimp server prefix (e.g., us21). Found in your API key or account URL. |
Target Settings
| Field | Type | Required | Description |
|---|---|---|---|
| Audience/List ID | Text | Yes | The Mailchimp audience (list) ID to sync contacts to |
| Tag Name | Text | No | Optional tag to apply to synced contacts |
Supported Operations
Sync Modes: Upsert, Insert
Audience Sync Modes: Add, Remove, Mirror, Upsert
Features
- Field Mapping: Yes
- Schema Introspection: No
Required Mapping Fields
| Field | Description |
|---|---|
| email_address | Subscriber email address |
Default Destination Fields
email_address, FNAME, LNAME, PHONE, ADDRESS, BIRTHDAY, status
Troubleshooting
Invalid API key format
Mailchimp API keys must follow the format {key}-{server_prefix} (e.g., abc123-us21).
List/Audience ID not found
Find the Audience ID in Mailchimp under Audience > Settings > Audience name and defaults. The ID is a 10-character alphanumeric string.
Subscriber already exists
Use Upsert mode to update existing subscribers instead of getting duplicate errors with Insert mode.