API Provider Setup

To authenticate a MailChimp v3.0 element instance you must register an app with MailChimp. When you authenticate, use the Client Id, Client Secret, and Redirect URI as the API Key, API Secret, and Callback URL. If you plan to monitor events, also set up webhooks by following the steps in Set Up Events.

See the latest setup instructions in the MailChimp documentation.

Locate Credentials for Authentication

If you already created an application, follow the steps below to locate the Client Id, Client Secret, and Redirect URI. If you have not created an app, see Create an Application.

To find your OAuth 2.0 credentials:

1. Log in to your account at MailChimp.
2. In the upper right corner, click your name, and then select Account.
3. Click Extras, and then select Registered apps.
4. Locate your app, and then click Edit.
5. Scroll down and record the the Redirect URI, Client Id, and Client Secret.

Create an Application

If you have not created an application, you need one to authenticate with MailChimp.

To create an application:

1. Log in to your account at MailChimp.
2. In the upper right corner, click your name, and then select Account.
3. Click Extras, and then select Registered apps.
4. Click Register an App.
5. Complete the required information.
6. In Redirect URI enter the URL that will receive the authorization grant code and return users upon authentication during the OAuth Authorization process.
7. Click Create.
8. Scroll down and record the the Redirect URI, Client Id, and Client Secret.

Set Up Events

MailChimp supports webhooks. If you want to enable events when you authenticate an element instance, complete the steps below to set up webhooks with MailChimp. You can set up webhooks after you authenticate with a POST /lists/{id}/webhook request.

To set up webhooks:

1. Log in to your account at MailChimp.
2. Navigate to your Lists
3. Choose the list to add a webhook to, and then navigate to the Settings.
4. Scroll down and click Webhooks.
5. Click Create New Webhook.
6. In Callback URL enter the URL to receive webhook notifications, such as https://api.cloud-elements.com/elements/api-v2/events/mailchimpv3.
7. Set up your webhook, and then click Save.
8. Record the Callback URL which you will use when you set up events as the Event Notification Callback URL.

Next authenticate an element instance with MailChimp.