Mailchimp (Event stream)

Amplitude's Mailchimp streaming integration forwards your Amplitude events and users to Mailchimp.

Set up the integration

Create a new sync

In Amplitude Data, click Catalog and select the Destinations tab.
In the Event Streaming section, click Mailchimp.
Enter a sync name, then click Create Sync.

Enter credentials

Select your Mailchimp Account Name or select "Authenticate with Mailchimp" to connect a new Mailchimp account.
Enter your Mailchimp Audience ID. Refer to the Mailchimp documentation for instructions on finding your audience ID.
Select an option for Status if New. This setting is the status to assign to new users created in Mailchimp. The setting applies only to Send Users. If you only have Send Events enabled, you can ignore this item.

Configure mappings

This applies to both event and user forwarding.

Select an Amplitude user property that corresponds to your Mailchimp emails, from the left dropdown.

Configure event forwarding

Under Send Events, make sure the toggle is enabled ("Events are sent to Mailchimp") if you want to stream events to Mailchimp. When enabled, events are automatically forwarded to Mailchimp when they're ingested in Amplitude. Events aren't sent on a schedule or on-demand using this integration. The occurred_at field on the Mailchimp event is the date and time at which the event is ingested in Mailchimp, not Amplitude.

In Select and filter events choose which events you want to send. Choose only the events you need in Mailchimp.

Streaming events of anonymous users isn't supported

Mailchimp requires that all events have a user ID (email) present. If you have selected any events to send to Mailchimp that may not have a user ID, add a filter to send only events where the user ID is present. Additionally, events can only be streamed for users that already exist in Mailchimp. Otherwise, your delivery metrics may be affected.

(optional) In Select additional properties, select any more event and user properties you want to send to Mailchimp. If you don't select any properties here, Amplitude doesn't send any. These properties are sent to Mailchimp as Mailchimp event properties.

Configure user forwarding

Under Send Users, make sure the toggle is enabled ("Users are sent to Mailchimp") if you want to stream users and their properties to Mailchimp. When enabled, users are automatically created or updated in Mailchimp when an event is sent to Amplitude. Amplitude Identify API calls are also forwarded to Mailchimp. Users aren't sent on a schedule or on-demand using this integration.

(optional) In Select additional properties, select any more user properties you want to send to Mailchimp. If you don't select any properties here, Amplitude doesn't send any. These properties are sent to Mailchimp as Mailchimp merge fields.

Create your user properties

All additional user properties must be manually created in Mailchimp. Create a merge field in Mailchimp for each user property, with the exact same ID (not the display name). Any properties not created in this way in Mailchimp are skipped.

Enable sync

When satisfied with your configuration, at the top of the page toggle the Status to "Enabled" and click Save.

Was this helpful?