Mailchimp Connector

Prerequisites

• A Mailchimp account (Free or any paid plan)
• Account Owner or Admin access

Getting Your Credentials

Mailchimp uses an API Key for authentication.

1. Log into Mailchimp
2. Click your profile icon in the bottom-left
3. Go to Account & billing > Extras > API keys
4. Click Create A Key
5. Name it (e.g., Landed sync)
6. Copy the key

The key format is xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx-usN where usN is your datacenter (e.g., us6). The datacenter suffix is required -- Landed uses it to route requests to the correct Mailchimp server.

Configuration in Landed

Field	Value
API Key	Your Mailchimp API key (e.g., abc123def456-us6)

Available Streams

Stream	Description	Sync Mode
lists	Audience lists with stats (member count, open rate, click rate)	Full refresh
members	List members with email, status, merge fields, tags	Incremental
campaigns	Email campaigns with settings and tracking	Incremental
reports	Campaign performance reports (opens, clicks, bounces)	Full refresh
segments	Audience segments within lists	Full refresh
segment_members	Members belonging to each segment	Full refresh
unsubscribes	Unsubscribed contacts per campaign	Full refresh

Common Issues

Symptom	Cause	Fix
Invalid API Key	Key format wrong or missing datacenter suffix	Ensure key ends with -usN (e.g., -us6)
401 API Key Invalid	Key was revoked or deleted	Generate a new key in Mailchimp
403 Forbidden	Insufficient permissions	Use an Account Owner or Admin API key
Rate limit exceeded	Too many API calls	Landed handles rate limiting automatically; Mailchimp allows 10 concurrent connections

Data Notes

• Mailchimp API returns timestamps in UTC
• Member data includes merge fields (custom fields) as configured in your audience
• Mailchimp limits list API responses to 1,000 members per page

Static IPs for Allowlisting

If your network configuration requires IP allowlisting:

• Production: 34.170.185.84, 35.192.90.94
• Staging: 34.171.93.34