This article walks you through installing and configuring the Mailchimp subscription in iPaaS.com, from obtaining your Mailchimp API key to verifying that data flows correctly.
Before You Begin
Before you install the Mailchimp subscription, obtain an API key and your API URL from Mailchimp.
To create an API key:
Log in to your Mailchimp account.
Click your account icon (your initials) in the upper-right corner.
Select Profile from the menu.
Click Extras, and then select API keys.
Scroll to the Your API keys section. Existing keys cannot be viewed or copied again after they are created.
Click Create A Key. Mailchimp generates the key.
Click Copy to Clipboard and save the API key in a safe place for later use.
Click Done. Your new key is listed in the Your API keys section.
To find your API URL, look at your browser address while logged in to Mailchimp. It looks like https://us13.admin.mailchimp.com. Replace admin with api to get your API URL — for example, https://us13.api.mailchimp.com. The region prefix (such as us13) varies by account.
Go to the next section to install the Mailchimp subscription.
Installation Instructions for Integration Setup
Go to Subscriptions Management > Subscriptions and click Search Certified Integration Marketplace and Subscribe.
Click the Mailchimp Integration title.
On the Subscription Detail page, click the Subscribe button.
Enter the Name of the subscription and select a Version. The name can be any relevant, unique subscription name within the company where the subscription is created.
Format: [Product Name] - [Environment/Purpose]
Example: Mailchimp - Release
Select Create Default Mappings (recommended). If you want to create all mappings yourself, clear this checkbox.
Provide the API Url for your Mailchimp account, in the form
https://<region>.api.mailchimp.com(for example,https://us13.api.mailchimp.com). Use the region prefix shown in your Mailchimp browser address.Enter the API Key you generated in Mailchimp.
(Optional) Enter the Variant External Id Delimiter. This is the single character that separates the product identifier from the variant identifier when the integration builds a variant's external identifier. For example, using the pipe character (
|) with product ID12345and variant ID67890produces the external ID12345|67890.(Optional) Enter the Special Character Replacement. This is a safe character (such as
_or-) that replaces reserved characters in product and variant identifiers before they are sent to Mailchimp. Reserved characters such as/,?, or#can break the request. When the integration encounters one of these characters in an identifier, it substitutes your configured replacement character. If your identifiers can contain these characters and no replacement character is configured, those updates fail with an error.(Optional) Set Use Store Id From Transaction to
trueorfalse. When set totrue, the integration carries the store identifier from each incoming order through to the related customer, product, and variant records, keeping them associated with the correct Mailchimp store. When set tofalseor left blank, the order's store identifier is not propagated in this way.(Optional) Enter the Customer Store Id Custom Field Name. This is the name of the customer custom field that the store identifier is written to and read from. It is used together with Use Store Id From Transaction to locate the store identifier on customer records.
Enter the API Throttle Limit. This controls the number of API requests the subscription can make within the throttle window, protecting system performance and ensuring fair usage.
Recommended Values
Initial Setup: 5
Ongoing Operations: 500
High Volume: 500
Enter the API Throttle Seconds. This defines the time window over which the API Throttle Limit is measured. If the subscription exceeds the limit within this window, additional requests are held until the window resets.
Default Value: 60 seconds
Enter the number of Concurrent Connections. This specifies the maximum number of simultaneous API connections the subscription can process. If the limit is exceeded, new requests are queued or rejected until an active connection finishes.
Default Value: 5
Enter the number of Concurrent Batch Executions. This specifies the maximum number of simultaneous batch executions that can process for the subscription at one time. If the limit is exceeded, new requests are queued or rejected until an active execution finishes.
Default Value: 5
Click Apply to save the settings.
Post-Installation Verification
After completing the installation, perform these tests to verify the integration is working.
Data Sync Test
Initiate a sample data push from iPaaS.com to Mailchimp.
Confirm the record (for example, a customer or order) appears in Mailchimp.
Functionality Test
Run an end-to-end business process.
Validate key behavior such as field mappings and record creation in Mailchimp.
Review integration activity under Dashboard / Integration Monitoring / Error Logs in iPaaS.com to confirm there are no errors.
Support and Troubleshooting
Click the Help button on any iPaaS.com page to contact Support or to search our documentation.
Documentation: Search our documentation at the top of this article.
Support Portal: Click the Help and Support button at the lower-right of the window.
Contact Information: Contact iPaaS.com.



