Mailchimp is an email marketing and automation platform used to manage audiences, send campaigns, and track engagement. With BonData, you can connect to your Mailchimp account to read, enrich, and sync your marketing data - including audiences, members, and campaign performance - within Agent workflows.
Mailchimp Authentication Setup
BonData supports connecting to Mailchimp with OAuth or with an API Key. OAuth is the simplest option; an API Key is useful for service accounts and headless setups.
OAuth (Recommended)
API Key
- In BonData, navigate to Integrations and select Mailchimp
- Click Connect
- You’ll be redirected to Mailchimp to authorize the connection
- Sign in and click Allow to grant access
- You’ll be redirected back to BonData once connected
Step 1: Generate an API Key
- Log in to Mailchimp
- Click your profile name in the bottom-left, then Account & billing
- Go to Extras → API keys
- Click Create A Key and copy the generated key
Step 2: Note Your Data Center
Your API key ends in a data center suffix, for example -us21. This suffix identifies your Mailchimp server region and is required to build the API endpoint.Step 3: Enter Credentials in BonData
- In BonData, navigate to Integrations and select Mailchimp
- Enter your API Key and Data Center
- Click Connect
The data center is the part after the dash in your API key. If your key is a1b2c3...-us21, your data center is us21 and all requests are routed to https://us21.api.mailchimp.com.
Required Fields
Available Data
Once connected, BonData can sync the following Mailchimp data:
- Audiences / Lists - Your subscriber lists with settings and stats
- Members / Contacts - Individual subscribers with status, merge fields, and engagement
- Campaigns - Sent, draft, and scheduled email campaigns
- Reports - Open rates, click rates, bounces, and other campaign metrics
- Automations - Automated customer journeys and their emails
- Segments - Saved and static segments within an audience
- Tags - Contact tags used for organizing and targeting members
