Mailchimp
This page guides you through setting up the Mailchimp source connector.
Prerequisites
For Airbyte Cloud
- Access to a valid Mailchimp account. If you are not an Owner/Admin of the account, you must be granted Admin access by the account's Owner/Admin.
For Airbyte Open Source
- A valid Mailchimp API Key (recommended) or OAuth credentials: Client ID, Client Secret and Access Token
Setup guide
Airbyte Open Source: Generate a Mailchimp API key
- Navigate to the API Keys section of your Mailchimp account.
- Click Create New Key, and give the key a name to help you identify it. You won't be able to see or copy the key once you finish generating it, so be sure to copy the key and store it in a secure location.
For more information on Mailchimp API Keys, please refer to the official Mailchimp docs. If you want to use OAuth authentication with Airbyte Open Source, please follow the steps laid out here to obtain your OAuth Client ID, Client Secret and Access Token.
Set up the Mailchimp source connector
- Log into your Airbyte Cloud or Airbyte Open Source account.
- Click Sources and then click + New source.
- Find and select Mailchimp from the list of available sources.
- Enter a name for your source.
- You can use OAuth or an API key to authenticate your Mailchimp account. We recommend using OAuth for Airbyte Cloud and an API key for Airbyte Open Source.
- To authenticate using OAuth for Airbyte Cloud, click Authenticate your Mailchimp account and follow the instructions to sign in with Mailchimp and authorize your account.
- To authenticate using an API key for Airbyte Open Source, select API key from the Authentication dropdown and enter the API key for your Mailchimp account.
- To authenticate using OAuth credentials, select Oauth2.0 from the dropdown and enter the Client ID, Client Secret and Access Token you obtained.
- (Optional) You may optionally provide an Incremental Sync Start Date using the provided datepicker, or by programmatically entering a UTC date-time in the format
YYYY-MM-DDThh:mm:ss.sssZ
. If set, only data generated on or after the configured date-time will be synced. Leaving this field blank will sync all data returned from the API. - Click Set up source and wait for the tests to complete.
Supported streams
The Mailchimp source connector supports the following streams and sync modes:
Stream | Full Refresh | Incremental |
---|---|---|
Automations | ✓ | ✓ |
Campaigns | ✓ | ✓ |
Email Activity | ✓ | ✓ |
Interests | ✓ | |
Interest Categories | ✓ | |
Lists | ✓ | ✓ |
List Members | ✓ | ✓ |
Reports | ✓ | ✓ |
Segments |