Connect Your MailChimp Account

To connect Odoo with MailChimp you need an API key from your MailChimp account. The key authorizes Odoo to read and write audiences, contacts, templates and campaigns on your behalf.

Create the API Key in MailChimp

  1. Log in to your MailChimp account at mailchimp.com.

  2. Click your profile icon and go to Account & billing ‣ Extras ‣ API keys.

  3. In the Your API keys section, click Create A Key (or Create New Key).

  4. Give the key a label you recognize (for example Odoo) and copy the generated key to your clipboard.

MailChimp API keys page

Warning

Treat the API key like a password. Anyone with the key can access your MailChimp data. If a key is exposed, click Revoke next to it in MailChimp and create a new one.

Note

A MailChimp API key always ends with a data-center suffix (the part after the -, e.g. ...-us20). Odoo reads this suffix automatically to reach the correct MailChimp server, so copy the entire key.

Add the Account in Odoo

  1. In Odoo, open the Email Marketing app and go to MailChimp ‣ Accounts, then click New.

  2. Enter an Account Name (for example TeqStars MailChimp).

  3. On the Authentication section, paste the key into the API Key field.

Paste the API key in the Odoo MailChimp account

Tip

You can create several MailChimp accounts in the same Odoo database — one per API key. Each account keeps its own audiences, campaigns and settings.

Test the Connection

Click Test Connection in the form header. If the key is valid, a success message appears and your Odoo and MailChimp are connected.

Test connection success

Note

If the test fails, your API key may be invalid or incomplete, or it may point to the wrong data center. Re-copy the full key from MailChimp and try again.

Next Steps

After the connection succeeds, configure the account behavior and start importing your MailChimp data:

See also