MailChimp Connector FAQs

These frequently asked questions cover the most common setup and synchronization topics for the Odoo MailChimp Connector. For a full feature list, see MailChimp Connector Features.

Getting Started

A single API key from your MailChimp account. The key already includes the data-center suffix Odoo needs (for example ...-us20). See Connect Your MailChimp Account.

Use the Quick Setup wizard. It validates the API key, links audiences, maps merge fields and turns on synchronization in one flow. Open it from Quick Setup on the account dashboard. See Quick Setup Wizard.

Yes. Create one account per API key in Email Marketing ‣ MailChimp ‣ Accounts. Each account keeps its own audiences, campaigns and settings.

The connector depends on Email Marketing (every MailChimp audience becomes a native mailing list) and Sales (for exporting sale orders to MailChimp).

Audiences & Contacts

By email. When a member is not found and Auto Create Member In Odoo? is enabled, Odoo creates a mailing contact (and a customer too, if Auto Create Customers In Odoo? is on). See MailChimp Account Configuration.

An address is exported only when all of street, city, state, ZIP and country are filled. Incomplete addresses are skipped.

Enable Auto Export Contact? on the audience and set a filter. The scheduled action then exports matching contacts. See Auto Export.

Odoo posts a note in the chatter to warn you. Because MailChimp identifies members by email, the next export creates a new MailChimp member. The old one stays in MailChimp until you remove it there. See Members / Contacts Management.

Campaigns & Templates

In Email Marketing ‣ Mailings, click New to create a campaign, select a MailChimp Template and a MailChimp audience, then use Send, Schedule or Test. See Campaigns Management.

Yes. A MailChimp campaign can target multiple lists/audiences.

Open the campaign and click Fetch Report from MailChimp in the header. Odoo pulls the latest opens, clicks and bounces from MailChimp right away. See Campaigns Management.

After sending, the scheduled action imports opens, clicks and bounces for the period set by Campaign Report (5 days by default). See Campaign Report Duration.

Templates can only be pushed to a MailChimp account that is in Confirmed state. Open the account and click Confirm first. See MailChimp Account Configuration.

Webhooks & Sync

They’re optional but recommended. Webhooks update Odoo in real time on subscribe, unsubscribe, profile, cleaned and delete events. Without them, the scheduled sync still keeps data aligned. See Webhook Configuration.

Open the audience, go to the Webhook Configuration tab and click Enable Webhook. Odoo creates the webhook in both systems for you. Repeat for each audience you want to keep in real-time sync. See Webhook Configuration.

MailChimp can only deliver to a public HTTPS URL. Confirm your Odoo instance is reachable over HTTPS and that the webhook is enabled on the audience.

No data is lost. The scheduled action acts as a safety net, on its next run it reconciles the audience and pulls any changes the webhook didn’t deliver. You can also run Fetch Members on the audience manually at any time.

Ecommerce (Stores, Products & Orders)

Either pull existing stores with Fetch Stores on the account, or create a new one from Email Marketing ‣ MailChimp ‣ Stores, fill in the details and click Create Store. See Stores Management.

It tells MailChimp to temporarily pause the store’s order-driven automations (Order notifications, Abandoned carts, First purchases, Best customers), so you can add, edit or backfill order data without triggering old messages. Turn it off and click Update Store to resume live automations. See Stores Management.

Every variant must have an SKU (Internal Reference), because MailChimp uses it as the unique variant identifier. Fill in the SKU on the Odoo product and export again. See Products Management.

By the sale order’s Company. In a multi-company setup, create one store per company so every order has a matching store. See Orders Management.

Troubleshooting

  • Re-copy the full API key, including the -xxxx data-center suffix.

  • Make sure the key hasn’t been revoked in MailChimp.

  • Create a fresh key if in doubt and confirm again.

In the MailChimp Logs. The connector records failed exports/updates there and keeps processing the remaining records. See Job Queue and Logs.

Open the job from Email Marketing ‣ MailChimp ‣ Job Queue, check the Exception Message for the cause, fix the source data if needed, and click Retry. See Job Queue and Logs.

See also