MailChimp Connector FAQs¶

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

Getting Started¶

What credentials does the connector need?

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

Can I connect more than one MailChimp account?

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

What Odoo app does it depend on?

The connector depends on the Email Marketing app, every MailChimp audience becomes a native Odoo mailing list.

Audiences & Contacts¶

How are MailChimp members matched to Odoo 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.

What do the contact/subscriber status mean?

Subscribed recipients receive campaigns, Unsubscribed opted out, Cleaned are undeliverable (and blacklisted in Odoo), Transactional are on the list but excluded from marketing sends.

Why aren’t a contact’s address fields exported?

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

How do I push Odoo contacts into MailChimp automatically?

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

Campaigns & Templates¶

How do I send a campaign through MailChimp?

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.

Can a campaign target more than one list?

Yes. A MailChimp campaign targets a multiple list/audience.

When do campaign statistics appear in Odoo?

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

Webhooks & Sync¶

Do I need webhooks?

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.

Why isn’t my webhook working?

MailChimp can only deliver to a public HTTPS URL. Confirm your Odoo instance is reachable over HTTPS and that the Webhook URL was generated on the account.

What if a webhook is missed or fails?

No data is lost. The Fetch MailChimp Audience 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.

Troubleshooting¶

Test Connection fails — what should I check?

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 test again.

Where do I see errors?

In the MailChimp logs, the connector records failed exports/updates there and keeps processing the remaining records.