Skip to main content

Mailchimp Connections and Settings

How to connect iPaaS.com to Mailchimp: prerequisites, the Mailchimp Marketing API key, and every subscription setting explained.

See what the Mailchimp integration can do →

This article explains how to connect your Mailchimp account to iPaaS.com and how to configure the subscription settings that control how the integration sends data to Mailchimp. The integration synchronizes Customers, Products, Product Variants, Orders, and Order Lines from iPaaS.com to your Mailchimp account using the Mailchimp Marketing API.

How to Connect

Prerequisites

Before setting up the Mailchimp integration in iPaaS.com, ensure you have the following:

  • Active Mailchimp account: An active Mailchimp account with permission to create an API key (administrator or owner access).

  • A Mailchimp API key: Generate an API key in Mailchimp by following these steps:

    • Log in to your Mailchimp account.

    • Click your initials (account icon) in the upper-right corner.

    • Select Profile.

    • Navigate to Extras > API keys.

    • Click Create A Key.

    • Name the key (for example, "iPaaS.com").

    • Copy the generated key and save it for use in iPaaS.com. Mailchimp does not display the full key again after you leave this screen.

  • Your Mailchimp API URL: This is the base address for your Mailchimp account's region (its "server prefix" or data center). When you are logged in to Mailchimp, your browser address looks like https://us13.admin.mailchimp.com. Replace admin with api to get your API URL — for example, https://us13.api.mailchimp.com. The characters after https:// (such as us13) identify your region and vary from account to account.

Configure Subscription Settings

Navigate to the Mailchimp subscription settings in iPaaS.com and provide the following information. The first settings establish and authenticate the connection; the remaining settings are optional and control how product, variant, and order data is processed.

Field

Description

Required

API Url

The base API URL for your Mailchimp account's region, in the form https://<region>.api.mailchimp.com (for example, https://us13.api.mailchimp.com). The integration uses this address for all calls to Mailchimp.

Yes

API Key

The Mailchimp Marketing API key you generated in your Mailchimp account. The integration uses this key to authenticate every request.

Yes

Variant External Id Delimiter

The single character that separates the product identifier from the variant identifier when the integration builds a variant's external identifier. For example, with the pipe character (|), product 12345 and variant 67890 combine into 12345|67890.

No

Special Character Replacement

A safe character that replaces reserved characters (/, ?, and #) in product and variant identifiers before they are sent to Mailchimp. These reserved characters can break the request if left in place. If your product or variant identifiers can contain these characters and no replacement character is configured, those updates fail.

No

Use Store Id From Transaction

Accepts true or false. When set to true, the store identifier on an incoming order is carried through to the related customer, product, and variant records so all of them stay associated with the same Mailchimp store. When set to false or left blank, the order's store identifier is not propagated in this way.

No

Customer Store Id Custom Field Name

The name of the customer custom field that the store identifier is written to and read from. This setting is used together with Use Store Id From Transaction to locate the store identifier on customer records.

No

Authenticate the Connection

  1. Enter the API Url and API Key in the Mailchimp subscription settings, and confirm:

    • API Url matches the format https://<region>.api.mailchimp.com, using the region shown in your Mailchimp browser address.

    • API Key is the key you generated in the Prerequisites section.

  2. Click Save to store the settings.

The integration authenticates to the Mailchimp Marketing API using your API key. Mailchimp accepts the key with HTTP Basic authentication, where the username can be any value and the API key is supplied as the password; the integration handles this for you once the API Key and API Url are saved. (Source: Mailchimp Marketing API — Quick Start, mailchimp.com/developer, retrieved 2026-06-29.)

Initialization Support

Initialization is not supported for Mailchimp in iPaaS.com. Data synchronization and mappings are configured during setup rather than seeded by a bulk initialization step. For a one-time load of a large set of existing records, subscribers or their MiSP can perform a bulk sync using Postman.

Throttling

Throttling controls how many requests the integration sends to the Mailchimp API over a given period, preserving performance during heavy data transfers. The throttling fields are required, but their values are pre-populated by the integration settings. For more details, refer to Subscription Configuration – Edit.

Did this answer your question?