How to use IBM App Connect with Mailchimp

Mailchimp is an email marketing service that helps you to design and send email newsletters, invitations, reminders and more, to contacts in your lists. (In the Mailchimp UI, lists are referred to as audiences. A Mailchimp audience is used to collect and manage your subscribed, non-subscribed, and unsubscribed contacts.)
Availability:
  • App Connect Enterprise as a Service connector
  • A local connector in a Designer instance of IBM App Connect in containers (Continuous Delivery release)Local connector in containers (Continuous Delivery release) 12.0.7.0-r5 or later
  • A local connector in a Designer instance of IBM App Connect in containers (Support Cycle 2)Local connector in containers (Long Term Support Cycle-2 release)
The following information describes how to use IBM® App Connect to connect Mailchimp to your other applications.

Supported product and API versions

To find out which product and API versions this connector supports, see Detailed System Requirements on the IBM Support page.

Connecting to Mailchimp

To connect App Connect to an Mailchimp account that you want App Connect to use, you need the following connection details:

Mailchimp connection fields:

Authorization method Connection field Description Applicability
BASIC OAUTH Access token The OAuth 2.0 Access Token for authentication.
Tip: For more information about generating an access token, see Access Data on Behalf of Other Users with OAuth 2 on the Mailchimp developer page.
App Connect in containersand App Connect Enterprise as a Service
OAUTH 2.0 AUTH CODE
Tip: Authorize connection to Mailchimp by signing in to your account.
  App Connect Enterprise as a Service

To obtain the connection values for Mailchimp, see Obtaining connection values for Mailchimp.

To connect to a Mailchimp endpoint from the App Connect Designer Connect > Applications and APIs page (previously the Catalog page) for the first time, expand Mailchimp, then click Connect. For more information, see Managing accounts.

Tip:

Before you use the account that is created in App Connect in a flow, rename the account to something meaningful that helps you to identify it. To rename the account on the Applications and APIs page, select the account, open its options menu (⋮), then click Rename Account.

What should I consider first?

Before you use App Connect Designer with Mailchimp, take note of the following considerations:

  • (General consideration) You can see lists of the trigger events and actions that are available on the Applications and APIs page of the App Connect Designer.

    For some applications, the events and actions depend on the environment and whether the connector supports configurable events and dynamic discovery of actions. If the application supports configurable events, you see a Show more configurable events link under the events list. If the application supports dynamic discovery of actions, you see a Show more link under the actions list.

  • (General consideration) If you are using multiple accounts for an application, the set of fields that is displayed when you select an action for that application can vary for different accounts. In the flow editor, some applications always provide a curated set of static fields for an action. Other applications use dynamic discovery to retrieve the set of fields that are configured on the instance that you are connected to. For example, if you have two accounts for two instances of an application, the first account might use settings that are ready for immediate use. However, the second account might be configured with extra custom fields.
  • Before you add some of the Mailchimp events or actions to your flow, make sure you have the following resources:
    • If you choose the New Member event to trigger your flow, you must specify the name of an existing Mailchimp list; that's the list that App Connect will monitor for new members.
    • If you add the Add member to list action to your flow, you must have set up already a list in Mailchimp so that App Connect can add a member to that list.
    • If you add the 'Create campaign' action to your flow, you must have an existing list of members for App Connect to send your campaign to.

Events and actions

Mailchimp events

These events are for changes in this application that trigger a flow to start completing the actions in the flow.

Campaigns
New campaign
List members
New subscriber
Subscriber lists
New list
Messages
New message

Mailchimp actions

Your flow completes these actions on this application.

Campaign folders
Create campaign folder
Retrieve campaign folders
Delete campaign folders
Campaign reports
Retrieve campaign reports
Campaigns
Create campaign
Retrieve campaigns
Files
Create file
Retrieve files
Folders
Create folder
Retrieve folders
Delete folder
Interest categories
Create interest category
Retrieve interest categories
Interests
Create interest
Retrieve interests
Lists
Create list
Retrieve lists
Delete list
Members
Add subscriber to a list
Retrieve members
Recipient reports
Retrieve campaign recipient reports
Segments
Retrieve segments

Examples

Dashboard tile for a template that uses Mailchimp
Dashboard tile for a template that uses Mailchimp
Dashboard tile for a template that uses Mailchimp

Use templates to quickly create flows for Mailchimp

Learn how to use App Connect templates to quickly create flows that complete actions on Mailchimp. For example, open the Templates gallery, and then search for Mailchimp.

Dashboard tile for a template that uses Mailchimp