Create and update Mailchimp contacts from analytics events

You can use your PostHog event data to create and update contacts in Mailchimp. Here's everything you need to get started.

Requirements

Using this requires either PostHog Cloud with the data pipelines add-on, or a self-hosted PostHog instance running a recent version of the Docker image.

Configuring Mailchimp

First, create a new API key in your Mailchimp account.

You'll also need your Mailchimp audience ID.

Finally, while logged into Mailchimp, check the subdomain of your account. You'll need this to configure the destination, as your Mailchimp datacenter id.

Configuring PostHog’s Mailchimp destination

1. In PostHog, click the Data pipeline tab in the left sidebar.
2. Click the Destinations tab.
3. Click New destination and choose Mailchimp's Create button.

Insert your API key, audience ID, and datacenter ID. You can also choose a different property to use as the contact's email; PostHog will default to person.properties.email.

You can additionally forward all event properties to Mailchimp, or select specific ones using the merge field section.

# Create a new destination
curl --location 'https://us.i.posthog.com/api/environments/:project_id/hog_functions' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer <POSTHOG_PERSONAL_API_KEY>' \
--data '{
    "type": "destination",
    "name": "Mailchimp",
    "inputs": {
        "apiKey": {
            "value": ""
        },
        "audienceId": {
            "value": ""
        },
        "dataCenterId": {
            "value": ""
        },
        "email": {
            "value": ""
        },
        "doubleOptIn": {
            "value": ""
        },
        "include_all_properties": {
            "value": ""
        }
    },
    "enabled": true,
    "template_id": "template-mailchimp"
}'