Mailchimp Enrichment Integration

Setup Guide

Get API credentials

Generate a Mailchimp API key and Factr API key.

Build an enrichment script

Create a scheduled job that pulls new subscribers and enriches them via Factr.

Store facts in merge fields

Use Mailchimp merge fields to store the enriched facts.

Segment by enrichment data

Create dynamic segments based on enriched attributes for targeted campaigns.

Code Example

JavaScript / Node.js

// Mailchimp subscriber enrichment
const mailchimp = require('@mailchimp/mailchimp_marketing');
mailchimp.setConfig({ apiKey: process.env.MAILCHIMP_API_KEY });

async function enrichMailchimpSubscriber(listId, email) {
  // Get subscriber first
  const subscriber = await mailchimp.lists.getListMember(listId, email);

  // Enrich with Factr
  const factrRes = await fetch('https://factr.polsia.app/api/enrich', {
    method: 'POST',
    body: JSON.stringify({ email, apiKey: process.env.FACTR_API_KEY })
  });
  const { fact } = await factrRes.json();

  // Update merge fields
  await mailchimp.lists.updateListMember(listId, email, {
    merge_fields: { ENRICHED_FACT: fact }
  });
}

Key Benefits

Dynamic segmentation based on insights
Automated enrichment at scale
Reduce unsubscribes with personalization
Track which insights drive engagement

Mailchimp + Factr