Skip to main content
Mailchimp holds your email marketing intelligence — subscriber demographics, campaign performance, A/B test results, interest tags, and engagement history. These six jobs connect that data to Mavera’s surfaces (Custom Personas, Brand Voice, Focus Groups, Generate, Mave Agent) so your personas reflect real subscriber segments, your content matches winning patterns, and your subject lines are tested before you hit send.

​
API Reference Card

DetailValue
Base URLhttps://{dc}.api.mailchimp.com/3.0/
AuthAPI Key via HTTP Basic (anystring:API_KEY) or OAuth 2.0
Rate limits10 simultaneous connections
Data centerExtract dc from your API key (e.g. us14 from abc123-us14)
Mavera basehttps://app.mavera.io/api/v1
Mavera authAuthorization: Bearer mvra_live_...
All examples use three environment variables: MAILCHIMP_API_KEY (your full API key including the -dc suffix), MAILCHIMP_DC (data center, e.g. us14), and MAVERA_API_KEY. Python examples use requests with Basic Auth (anystring as username, API key as password); JavaScript examples use fetch with the same pattern.

​
Prerequisites

1

Mailchimp account with data

You need a Mailchimp account with at least one audience (list) containing subscribers and at least 5 sent campaigns with performance data.
2

API key

Generate an API key in Mailchimp → Account & Billing → Extras → API keys. The key includes your data center suffix (e.g. abc123def456-us14).
3

Extract data center

The dc is the portion after the dash in your API key. For abc123def456-us14, your DC is us14 and your base URL is https://us14.api.mailchimp.com/3.0/.
4

Mavera API key

Get your key from Mavera dashboard.
5

Environment variables

export MAILCHIMP_API_KEY="abc123def456-us14"
export MAILCHIMP_DC="us14"
export MAVERA_API_KEY="mvra_live_xxxxx"

​
Jobs

#JobMailchimp DataMavera SurfaceOutput
1Subscriber Segment → Persona CreationSegments + MembersCustom PersonasSegment-grounded personas
2Campaign Performance → Content OptimizationCampaign ReportsBrand VoiceWinning-content-derived brand voice
3Email A/B Winner → Focus Group WhyA/B Test ResultsFocus GroupsQualitative A/B explanation
4Audience Interest Tags → Content GenerationInterest CategoriesGenerateInterest-personalized email content
5Re-Engagement Campaign BuilderInactive SubscribersMave Agent + GenerateMulti-step re-engagement sequences
6Open Rate PredictionHistorical CampaignsFocus GroupsSubject line testing with synthetic audience

​
Rate Limits & Production Notes

Mailchimp APILimitStrategy
All endpoints10 simultaneous connectionsUse sequential requests with 300-500ms delays
Members endpoint1,000 per page; max 10 concurrentPaginate with offset; add delays
Campaign reportsSame connection poolCache results; reports don’t change after send
Mailchimp’s 10 simultaneous connections limit is strict and applies per API key. If you run multiple jobs in parallel, you’ll exceed this quickly. Run jobs sequentially or use separate API keys for concurrent workloads.
Production checklist:
ConcernRecommendation
API key securityMailchimp API keys have full account access. Use OAuth 2.0 for production integrations with scoped permissions.
Data center routingAlways extract the dc from your API key. Using the wrong DC returns 403. Format: https://{dc}.api.mailchimp.com/3.0.
Batch operationsFor creating/updating many subscribers, use Mailchimp’s Batch Operations endpoint instead of individual calls.
Webhook vs. pollingFor real-time campaign events, use Mailchimp webhooks instead of polling the API. Configure in Audience → Settings → Webhooks.
Mavera creditsMonitor at Dashboard. Job 6 (open rate prediction) with 4 personas × 4 questions is credit-intensive.
List hygieneJob 5 identifies inactive subscribers. After re-engagement attempts, clean unresponsive addresses to maintain deliverability.

​
What’s Next

All Integrations

50+ API integrations with full code

Mailchimp API Docs

Official Mailchimp Marketing API reference

Personas API

Full reference for POST /api/v1/personas

Focus Groups API

Full reference for POST /api/v1/focus-groups

Brand Voice API

Full reference for POST /api/v1/brand-voices

Generate API

Full reference for POST /api/v1/generations