Members / Contacts Management¶
Keeping members in sync is the heart of any MailChimp integration. The connector links MailChimp members with Odoo mailing contacts (and, optionally, customers), in both directions, so subscribing, unsubscribing and profile changes stay consistent across both systems.
How Member Sync Behaves¶
What happens during sync, whether Odoo auto-creates mailing contacts and customers, pushes updates back to MailChimp, syncs members on a schedule, and overrides the contact name, is controlled by the account’s Member Options.
Note
These member/contact options live on the MailChimp account’s Settings tab and are configured once. For a full description of each one, see MailChimp Account Configuration.
Import Members (MailChimp to Odoo)¶
There are three ways members come into Odoo:
Manually: on an audience, click Fetch Members (see Lists / Audiences Management).
On schedule: the Fetch MailChimp Audience scheduled action imports members automatically when Auto Sync Member? is enabled.
In real time: an enabled webhook creates or updates the contact the moment a subscriber changes in MailChimp (see Webhook Configuration).
Each imported member becomes a mailing contact with its status (subscribed, unsubscribed, cleaned, transactional), its tags, and any merge-field values mapped to Odoo fields.
Note
Members with a cleaned status are added to the Odoo blacklist automatically, so you never email an undeliverable address.
Export a Contact (Odoo to MailChimp)¶
A single record can be pushed to MailChimp from either a customer or a mailing contact, using the same two cog (⚙) menu actions:
Export to MailChimp: Adds the contact to a MailChimp audience.
Update to MailChimp: Pushes the contact’s latest details (email, status, mapped merge fields and tags) to the matching MailChimp member.
From a Customer¶
On a customer form, open the cog menu and choose or .
A wizard opens where you pick the MailChimp List(s) the customer should be added to. Select the audiences and click Export.
Tip
The MailChimp List tab on the customer form shows which audiences the contact already belongs to and whether they are opted out. Handy before exporting again.
From a Mailing Contact¶
On a mailing contact form (), open the cog menu and choose Export To MailChimp or Update To MailChimp. The contact is exported to the MailChimp audiences it is already subscribed to (the lines on its Subscriptions tab).
The Subscriptions tab lists each audience the contact belongs to, with the Status (Mailchimp), the Opt Out flag and the subscription/unsubscription dates, so you can confirm the result after exporting.
Export Several Contacts at Once¶
You can export in bulk from a list view:
Customers: .
Mailing Contacts: , select records, then (or Update To MailChimp).
Tip
In the Mailing Contacts list, use the Pending for Export filter to quickly find contacts that belong to a MailChimp audience but have not been pushed yet.
Auto-Export Contacts¶
To keep an audience continuously filled, enable Auto Export Contact? on the audience and define a filter. Odoo then exports every matching contact on a schedule. See Auto Export Contacts to an Audience.
Export Logs¶
Every export or update run writes a MailChimp Log so you can see what happened. One log header is created per account per run, and each contact processed by that run becomes a line on the header. If MailChimp rejects a record (for example an invalid email), the failure is recorded on its own line and the rest of the batch keeps going.
Open the logs from . For the full log form (types, batch statuses, filters, retention), see Job Queue and Logs.
Note
Logs are written for scheduled and batch operations. A manual Export/Update shows the error directly on screen instead.
Real-time Updates¶
When a webhook is enabled for the audience, subscriber changes in MailChimp are pushed to Odoo instantly (subscribe, unsubscribe, profile update, cleaned address, and delete). See Webhook Configuration for the enable flow and a full event-by-event breakdown.