Mailchimp
Didomi allows you to update your Mailchimp contact attributes with the preferences collected through your preference management platform (PMP).
Didomi connects to Mailchimp on your behalf through API calls using an API key and a server name:
- Your server URL of your Mailchimp account:
https://<server_name>.admin.mailchimp.com/
Your
audience_id
is also required. It is the id of your Mailchimp Audience where all the contact creations and updates will be done by Didomi. To find your audience id, in your Mailchimp account, navigte to Audience → Manage audience → Settings → Audience name and default → Audience IDTherefore, every time preferences are collected using the Didomi Platform, it triggers the update of your Mailchimp contact property. You can use the Didomi user's property
organization_user_id
to identify and link your contacts on both platforms.- Upsert mode: You can choose allowing Didomi to create contacts in Mailchimp, by setting
upsert_mode
to true. Otherwise, when a consent is collected but theorganization_user_id
value does not match with any contact in Mailchimp, the consent update will not be propagated to Mailchimp. - Bidirectional flow: Please note that the bidirectional flow is not supported at the moment.
Didomi uses the entity contact of Mailchimp and sends the
merge tag
property when updating a contact. Hence consent events are mapped to the merge tag of Mailchimp contacts.For the PMP preferences with boolean type, please choose type
text
while creating audience fields and merge tags: the value that will be transferred to the merge tag will be true
or false
.Didomi needs the following configuration items to set up the connection with Mailchimp:
Property | Description | Required |
---|---|---|
Upsert mode | By setting upsert_mode to true you allow Didomi to create contacts in Mailchimp | No, Default value = false |
API Key | An API key from your Mailchimp account | Yes |
URL | The server URL of your Mailchimp account | Yes |
Audience id | The id of your audience where all contacts will be created or updated | Yes |
Properties | Mapping for properties between Didomi and Mailchimp | Yes |
{
"upsert_mode": true,
"config": {
"api_key": "your_api_key",
"url": "your_server_url",
"audience_id": "your_audience_id",
"properties": [
{
"id": "EMAIL_NOTIFICATION",
"value": "consents_purposes_newsletter_enabled"
}
]
}
}
The configuration of the Mailchimp integration cannot be done in the Didomi Console at the moment. Please reach out to [email protected] to get your Mailchimp integration configured and provide the elements listed above.
Last modified 2mo ago