From 0bc62a254b842728a05588d40e3776b8b53876ab Mon Sep 17 00:00:00 2001 From: annalvova Date: Wed, 23 Mar 2022 14:10:18 +0200 Subject: [PATCH 01/13] update doc --- .../source_mailchimp/spec.json | 2 +- docs/integrations/sources/mailchimp.md | 37 +++++++++++-------- 2 files changed, 23 insertions(+), 16 deletions(-) diff --git a/airbyte-integrations/connectors/source-mailchimp/source_mailchimp/spec.json b/airbyte-integrations/connectors/source-mailchimp/source_mailchimp/spec.json index 98de089a30c9..03dfde9b07d2 100644 --- a/airbyte-integrations/connectors/source-mailchimp/source_mailchimp/spec.json +++ b/airbyte-integrations/connectors/source-mailchimp/source_mailchimp/spec.json @@ -9,7 +9,7 @@ "properties": { "credentials": { "type": "object", - "title": "Authentication Method", + "title": "Authentication *", "oneOf": [ { "title": "OAuth2.0", diff --git a/docs/integrations/sources/mailchimp.md b/docs/integrations/sources/mailchimp.md index f59909ee2a55..d25c3e5d4f14 100644 --- a/docs/integrations/sources/mailchimp.md +++ b/docs/integrations/sources/mailchimp.md @@ -4,7 +4,10 @@ ### Output schema -The Mailchimp connector can be used to sync data for Mailchimp [Lists](https://mailchimp.com/developer/api/marketing/lists/get-list-info) and [Campaigns](https://mailchimp.com/developer/api/marketing/campaigns/get-campaign-info/). The linked Mailchimp documentation contains detailed description on the fields in each entity. +The Mailchimp connector can be used to sync data for Mailchimp [Lists](https://mailchimp.com/developer/api/marketing/lists/get-list-info), +[Campaigns](https://mailchimp.com/developer/api/marketing/campaigns/get-campaign-info/), +and [Email Activity](https://mailchimp.com/developer/marketing/api/email-activity-reports/). +The linked Mailchimp documentation contains a detailed description of the fields in each entity. Please [create a Github issue](https://github.com/airbytehq/airbyte/issues/new/choose) to request support for syncing more Mailchimp entities. @@ -21,22 +24,25 @@ Please [create a Github issue](https://github.com/airbytehq/airbyte/issues/new/c ### Features | Feature | Supported?\(Yes/No\) | Notes | -| :--- | :--- | :--- | -| Full Refresh Sync | Yes | | -| Incremental Sync | Coming soon | | -| Replicate Incremental Deletes | Coming soon | | -| SSL connection | Yes | Enabled by default | -| Namespaces | No | | +| :--- |:---------------------| :--- | +| Full Refresh Sync | Yes | | +| Incremental Sync | Yes | | +| Replicate Incremental Deletes | Coming soon | | +| SSL connection | Yes | Enabled by default | +| Namespaces | No | | ### Performance considerations -At the time of this writing, [Mailchimp does not impose rate limits](https://mailchimp.com/developer/guides/marketing-api-conventions/#throttling) on how much data is read form its API in a single sync process. However, Mailchimp enforces a maximum of 10 simultaneous connections to its API. This means that Airbyte will not be able to run more than 10 concurrent syncs from Mailchimp using API keys generated from the same account. +At the time of this writing, [Mailchimp does not impose rate limits](https://mailchimp.com/developer/guides/marketing-api-conventions/#throttling) +on how much data is read from its API in a single sync process. However, Mailchimp enforces a maximum of 10 simultaneous +connections to its API. This means that Airbyte will not be able to run more than 10 concurrent syncs from Mailchimp +using API keys generated from the same account. ## Getting started ### Requirements -For Apikey authorithation: +For Apikey authorization: * Mailchimp account * Mailchimp API key @@ -47,14 +53,15 @@ For OAuth authorization: ### Setup guide -To start syncing Mailchimp data with Airbyte, you'll need two things: +To start syncing Mailchimp data with Airbyte, you'll need to retrieve credentials. +According to the requirements you can use an API key or OAuth2.0 application. -1. Your Mailchimp username. Often this is just the email address or username you use to sign into Mailchimp. -2. A Mailchimp API Key. Follow the [Mailchimp documentation for generating an API key](https://mailchimp.com/help/about-api-keys/). +If you want to use an API key, please follow these Mailchimp steps: +* [Create account](https://mailchimp.com/developer/marketing/guides/quick-start/#create-an-account) +* [Generate API key](https://mailchimp.com/developer/marketing/guides/quick-start/#generate-your-api-key) -OR -1. Register an app in [Mailchimp](https://us2.admin.mailchimp.com/account/oauth2/). -2. Specify client_id and client_secret. +If you want to use [OAuth2.0](https://mailchimp.com/developer/marketing/guides/access-user-data-oauth-2/) creds, +please [register your application](https://mailchimp.com/developer/marketing/guides/access-user-data-oauth-2/#register-your-application). ## Changelog From 3376b69345b37c7f807e12ccef3fb3fe9167def8 Mon Sep 17 00:00:00 2001 From: annalvova Date: Wed, 23 Mar 2022 14:14:19 +0200 Subject: [PATCH 02/13] bump version --- .../connectors/source-mailchimp/Dockerfile | 2 +- docs/integrations/sources/mailchimp.md | 33 ++++++++++--------- 2 files changed, 18 insertions(+), 17 deletions(-) diff --git a/airbyte-integrations/connectors/source-mailchimp/Dockerfile b/airbyte-integrations/connectors/source-mailchimp/Dockerfile index 48591729451d..ec2fac69e9a0 100644 --- a/airbyte-integrations/connectors/source-mailchimp/Dockerfile +++ b/airbyte-integrations/connectors/source-mailchimp/Dockerfile @@ -12,5 +12,5 @@ RUN pip install . ENV AIRBYTE_ENTRYPOINT "python /airbyte/integration_code/main.py" ENTRYPOINT ["python", "/airbyte/integration_code/main.py"] -LABEL io.airbyte.version=0.2.12 +LABEL io.airbyte.version=0.2.13 LABEL io.airbyte.name=airbyte/source-mailchimp diff --git a/docs/integrations/sources/mailchimp.md b/docs/integrations/sources/mailchimp.md index d25c3e5d4f14..f6180b841b04 100644 --- a/docs/integrations/sources/mailchimp.md +++ b/docs/integrations/sources/mailchimp.md @@ -65,20 +65,21 @@ please [register your application](https://mailchimp.com/developer/marketing/gui ## Changelog -| Version | Date | Pull Request | Subject | -| :--- | :--- | :--- | :--- | -| 0.2.12 | 2022-03-17| [10975](https://github.com/airbytehq/airbyte/pull/10975) | Fix campaign's stream normalization | -| 0.2.11 | 2021-12-24| [7159](https://github.com/airbytehq/airbyte/pull/7159) | Add oauth2.0 support | -| 0.2.10 | 2021-12-21 | [9000](https://github.com/airbytehq/airbyte/pull/9000) | Update connector fields title/description | -| 0.2.9 | 2021-12-13 | [7975](https://github.com/airbytehq/airbyte/pull/7975) | Updated JSON schemas | -| 0.2.8 | 2021-08-17 | [5481](https://github.com/airbytehq/airbyte/pull/5481) | Remove date-time type from some fields | -| 0.2.7 | 2021-08-03 | [5137](https://github.com/airbytehq/airbyte/pull/5137) | Source Mailchimp: fix primary key for email activities | -| 0.2.6 | 2021-07-28 | [5024](https://github.com/airbytehq/airbyte/pull/5024) | Source Mailchimp: handle records with no no "activity" field in response | -| 0.2.5 | 2021-07-08 | [4621](https://github.com/airbytehq/airbyte/pull/4621) | Mailchimp fix url-base | -| 0.2.4 | 2021-06-09 | [4285](https://github.com/airbytehq/airbyte/pull/4285) | Use datacenter URL parameter from apikey | -| 0.2.3 | 2021-06-08 | [3973](https://github.com/airbytehq/airbyte/pull/3973) | Add AIRBYTE\_ENTRYPOINT for Kubernetes support | -| 0.2.2 | 2021-06-08 | [3415](https://github.com/airbytehq/airbyte/pull/3415) | Get Members activities | -| 0.2.1 | 2021-04-03 | [2726](https://github.com/airbytehq/airbyte/pull/2726) | Fix base connector versioning | -| 0.2.0 | 2021-03-09 | [2238](https://github.com/airbytehq/airbyte/pull/2238) | Protocol allows future/unknown properties | -| 0.1.4 | 2020-11-30 | [1046](https://github.com/airbytehq/airbyte/pull/1046) | Add connectors using an index YAML file | +| Version | Date | Pull Request | Subject | +|:--------|:-----------| :--- |:-------------------------------------------------------------------------| +| 0.2.13 | 2022-03-23 | [11352](https://github.com/airbytehq/airbyte/pull/11352) | Update spec&docs | +| 0.2.12 | 2022-03-17 | [10975](https://github.com/airbytehq/airbyte/pull/10975) | Fix campaign's stream normalization | +| 0.2.11 | 2021-12-24 | [7159](https://github.com/airbytehq/airbyte/pull/7159) | Add oauth2.0 support | +| 0.2.10 | 2021-12-21 | [9000](https://github.com/airbytehq/airbyte/pull/9000) | Update connector fields title/description | +| 0.2.9 | 2021-12-13 | [7975](https://github.com/airbytehq/airbyte/pull/7975) | Updated JSON schemas | +| 0.2.8 | 2021-08-17 | [5481](https://github.com/airbytehq/airbyte/pull/5481) | Remove date-time type from some fields | +| 0.2.7 | 2021-08-03 | [5137](https://github.com/airbytehq/airbyte/pull/5137) | Source Mailchimp: fix primary key for email activities | +| 0.2.6 | 2021-07-28 | [5024](https://github.com/airbytehq/airbyte/pull/5024) | Source Mailchimp: handle records with no no "activity" field in response | +| 0.2.5 | 2021-07-08 | [4621](https://github.com/airbytehq/airbyte/pull/4621) | Mailchimp fix url-base | +| 0.2.4 | 2021-06-09 | [4285](https://github.com/airbytehq/airbyte/pull/4285) | Use datacenter URL parameter from apikey | +| 0.2.3 | 2021-06-08 | [3973](https://github.com/airbytehq/airbyte/pull/3973) | Add AIRBYTE\_ENTRYPOINT for Kubernetes support | +| 0.2.2 | 2021-06-08 | [3415](https://github.com/airbytehq/airbyte/pull/3415) | Get Members activities | +| 0.2.1 | 2021-04-03 | [2726](https://github.com/airbytehq/airbyte/pull/2726) | Fix base connector versioning | +| 0.2.0 | 2021-03-09 | [2238](https://github.com/airbytehq/airbyte/pull/2238) | Protocol allows future/unknown properties | +| 0.1.4 | 2020-11-30 | [1046](https://github.com/airbytehq/airbyte/pull/1046) | Add connectors using an index YAML file | From 2cb8d1f07477aa8cd4c290d3891bc6ef495e2d5c Mon Sep 17 00:00:00 2001 From: annalvova Date: Fri, 1 Apr 2022 09:33:59 +0300 Subject: [PATCH 03/13] upd doc --- docs/integrations/sources/mailchimp.md | 12 +++++++++++- 1 file changed, 11 insertions(+), 1 deletion(-) diff --git a/docs/integrations/sources/mailchimp.md b/docs/integrations/sources/mailchimp.md index f6180b841b04..17354f7754f7 100644 --- a/docs/integrations/sources/mailchimp.md +++ b/docs/integrations/sources/mailchimp.md @@ -27,7 +27,7 @@ Please [create a Github issue](https://github.com/airbytehq/airbyte/issues/new/c | :--- |:---------------------| :--- | | Full Refresh Sync | Yes | | | Incremental Sync | Yes | | -| Replicate Incremental Deletes | Coming soon | | +| Replicate Incremental Deletes | No | | | SSL connection | Yes | Enabled by default | | Namespaces | No | | @@ -38,6 +38,16 @@ on how much data is read from its API in a single sync process. However, Mailchi connections to its API. This means that Airbyte will not be able to run more than 10 concurrent syncs from Mailchimp using API keys generated from the same account. +### Primary keys + +There is `id` primary key for `Lists` and `Campaigns`. +`Email Activity` hasn't primary key due to Mailchimp doesn't give it. + +### Incremental Deletes + +We don't support Incremental Deletes for `Campaigns`, `Lists`, and `Email Activity` streams. +Mailchimp doesn't give any information about deleted data in these streams. + ## Getting started ### Requirements From 84dc53517e4c618a351a42ff1d22ef6782262e5b Mon Sep 17 00:00:00 2001 From: annalvova Date: Tue, 12 Apr 2022 13:30:29 +0300 Subject: [PATCH 04/13] update doc --- .../connectors/source-mailchimp/Dockerfile | 2 +- docs/integrations/sources/mailchimp.md | 272 +++++++++++++++--- 2 files changed, 226 insertions(+), 48 deletions(-) diff --git a/airbyte-integrations/connectors/source-mailchimp/Dockerfile b/airbyte-integrations/connectors/source-mailchimp/Dockerfile index 4b357f002cf4..dd7ef7e9f4e7 100644 --- a/airbyte-integrations/connectors/source-mailchimp/Dockerfile +++ b/airbyte-integrations/connectors/source-mailchimp/Dockerfile @@ -12,5 +12,5 @@ RUN pip install . ENV AIRBYTE_ENTRYPOINT "python /airbyte/integration_code/main.py" ENTRYPOINT ["python", "/airbyte/integration_code/main.py"] -LABEL io.airbyte.version=0.2.13 +LABEL io.airbyte.version=0.2.14 LABEL io.airbyte.name=airbyte/source-mailchimp diff --git a/docs/integrations/sources/mailchimp.md b/docs/integrations/sources/mailchimp.md index fb91898880fa..cd0407508118 100644 --- a/docs/integrations/sources/mailchimp.md +++ b/docs/integrations/sources/mailchimp.md @@ -1,82 +1,260 @@ # Mailchimp -## Sync overview +This page guides you through the process of setting up the Mailchimp source connector. -### Output schema +## Prerequisites -The Mailchimp connector can be used to sync data for Mailchimp [Lists](https://mailchimp.com/developer/api/marketing/lists/get-list-info), -[Campaigns](https://mailchimp.com/developer/api/marketing/campaigns/get-campaign-info/), -and [Email Activity](https://mailchimp.com/developer/marketing/api/email-activity-reports/). -The linked Mailchimp documentation contains a detailed description of the fields in each entity. +For Apikey authorization: +* Mailchimp account +* Mailchimp API key -Please [create a Github issue](https://github.com/airbytehq/airbyte/issues/new/choose) to request support for syncing more Mailchimp entities. +For OAuth2.0 authorization: +* Mailchimp registered app +* Mailchimp client_id +* Mailchimp client_secret -### Data type mapping +## Step 1: Set up Source + +[Log in](https://login.mailchimp.com/) to Mailchimp account. +If you don't have a Mailchimp account already, you’ll need to [create](https://login.mailchimp.com/signup/) one in order to use the API. + +## Step 2: Set up the source connector in Airbyte + +**For Airbyte Cloud:** + +1. For using [OAuth2.0](https://mailchimp.com/developer/marketing/guides/access-user-data-oauth-2/) creds, +please [register](https://mailchimp.com/developer/marketing/guides/access-user-data-oauth-2/#register-your-application) +your Mailchimp account. +2. [Log into your Airbyte Cloud](https://cloud.airbyte.io/workspaces) account. +3. In the left navigation bar, click **Sources**. In the top-right corner, click **+ new source**. +4. On the Set up the source page, enter the name for the Mailchimp connector and select **Mailchimp** from the Source type dropdown. +5. Select `OAuth2.0` Authorization method, then click `Authenticate your account`. +6. Log in and Authorize to the Mailchimp account and click `Set up source`. + +**For Airbyte OSS:** + +1. For using an API key [create account](https://mailchimp.com/developer/marketing/guides/quick-start/#create-an-account) +in Mailchimp. +2. [Generate](https://mailchimp.com/developer/marketing/guides/quick-start/#generate-your-api-key) API key. +3. Go to local Airbyte page. +4. In the left navigation bar, click **Sources**. In the top-right corner, click **+ new source**. +5. On the Set up the source page, enter the name for the Mailchimp connector and select **Mailchimp** from the Source type dropdown. +6. Select `API key` Authorization method, then copy and paste your API key from step 2. +7. Click `Set up source`. -| Integration Type | Airbyte Type | Notes | -| :--- | :--- | :--- | -| `array` | `array` | the type of elements in the array is determined based on the mappings in this table | -| `date`, `time`, `datetime` | `string` | | -| `int`, `float`, `number` | `number` | | -| `object` | `object` | properties within objects are mapped based on the mappings in this table | -| `string` | `string` | | -### Features +## Supported sync modes -| Feature | Supported?\(Yes/No\) | Notes | -| :--- |:---------------------| :--- | -| Full Refresh Sync | Yes | | -| Incremental Sync | Yes | | -| Replicate Incremental Deletes | No | | -| SSL connection | Yes | Enabled by default | -| Namespaces | No | | +The Mailchimp source connector supports the following [sync modes](https://docs.airbyte.com/getting-started-with-airbyte-cloud/core-concepts#connection-sync-modes): + - Full Refresh + - Incremental -### Performance considerations +We don't support Incremental Deletes for `Campaigns`, `Lists`, and `Email Activity` streams. +Mailchimp doesn't give any information about deleted data in these streams. + +## Performance considerations At the time of this writing, [Mailchimp does not impose rate limits](https://mailchimp.com/developer/guides/marketing-api-conventions/#throttling) on how much data is read from its API in a single sync process. However, Mailchimp enforces a maximum of 10 simultaneous connections to its API. This means that Airbyte will not be able to run more than 10 concurrent syncs from Mailchimp using API keys generated from the same account. -### Primary keys +## Supported streams -There is `id` primary key for `Lists` and `Campaigns`. -`Email Activity` hasn't primary key due to Mailchimp doesn't give it. +This source is capable of syncing the following tables and their data: -### Incremental Deletes +**[Lists](https://mailchimp.com/developer/api/marketing/lists/get-list-info) Stream** -We don't support Incremental Deletes for `Campaigns`, `Lists`, and `Email Activity` streams. -Mailchimp doesn't give any information about deleted data in these streams. +``` +{ + "id": "q1w2e3r4t5", + "web_id": 000001, + "name": "Newsletter Subscribers", + "contact": { + "company": "", + "address1": "", + "address2": "", + "city": "San Francisco", + "state": "CA", + "zip": "00000-1111", + "country": "US", + "phone": "" + }, + "permission_reminder": "You are receiving this email because you opted in via our website.", + "use_archive_bar": true, + "campaign_defaults": { + "from_name": "Airbyte Community", + "from_email": "hey@email.com", + "subject": "", + "language": "en" + }, + "notify_on_subscribe": "", + "notify_on_unsubscribe": "", + "date_created": "2020-09-17T04:48:49+00:00", + "list_rating": 3, + "email_type_option": false, + "subscribe_url_short": "http://eepurl.com/hfpWAr", + "subscribe_url_long": "https://daxtarity.us2.list-manage.com/subscribe?u=q1q1q1q1q1q1q1q1q1q&id=q1w2e3r4t5", + "beamer_address": "us2-00000000-qqqqqqqqq@inbound.mailchimp.com", + "visibility": "prv", + "double_optin": false, + "has_welcome": false, + "marketing_permissions": false, + "modules": [], + "stats": { + "member_count": 4204, + "unsubscribe_count": 194, + "cleaned_count": 154, + "member_count_since_send": 91, + "unsubscribe_count_since_send": 19, + "cleaned_count_since_send": 23, + "campaign_count": 27, + "campaign_last_sent": "2022-04-01T14:29:31+00:00", + "merge_field_count": 5, + "avg_sub_rate": 219, + "avg_unsub_rate": 10, + "target_sub_rate": 18, + "open_rate": 39.478173607626694, + "click_rate": 8.504017780817234, + "last_sub_date": "2022-04-12T07:39:29+00:00", + "last_unsub_date": "2022-04-11T08:08:07+00:00" + }, + "_links": [ + { + "rel": "self", + "href": "https://us2.api.mailchimp.com/3.0/lists/q1w2e3r4t5", + "method": "GET", + "targetSchema": "https://us2.api.mailchimp.com/schema/3.0/Definitions/Lists/Response.json" + } + ] +} +``` -## Getting started +**[Campaigns](https://mailchimp.com/developer/api/marketing/campaigns/get-campaign-info/) Stream** -### Requirements +``` +{ + "id": "q1w2e3r4t5", + "web_id": 0000000, + "type": "regular", + "create_time": "2020-11-03T22:46:43+00:00", + "archive_url": "http://eepurl.com/hhSLxH", + "long_archive_url": "https://mailchi.mp/xxxxxxxx/weekly-bytes-learnings-from-soft-launch-and-our-vision-0000000", + "status": "sent", + "emails_sent": 89, + "send_time": "2020-11-05T16:15:00+00:00", + "content_type": "template", + "needs_block_refresh": false, + "resendable": true, + "recipients": { + "list_id": "1q2w3e4r", + "list_is_active": true, + "list_name": "Newsletter Subscribers", + "segment_text": "", + "recipient_count": 89 + }, + "settings": { + "subject_line": "Some subject", + "preview_text": "Text", + "title": "Newsletter", + "from_name": "Weekly Bytes from Airbyte", + "reply_to": "hey@email.com", + "use_conversation": false, + "to_name": "", + "folder_id": "", + "authenticate": true, + "auto_footer": false, + "inline_css": false, + "auto_tweet": false, + "fb_comments": true, + "timewarp": false, + "template_id": 0000000, + "drag_and_drop": false + }, + "tracking": { + "opens": true, + "html_clicks": true, + "text_clicks": false, + "goal_tracking": false, + "ecomm360": false, + "google_analytics": "", + "clicktale": "" + }, + "report_summary": { + "opens": 46, + "unique_opens": 33, + "open_rate": 0.0128372, + "clicks": 13, + "subscriber_clicks": 7, + "click_rate": 0.0383638, + "ecommerce": { + "total_orders": 0, + "total_spent": 0, + "total_revenue": 0 + } + }, + "delivery_status": { + "enabled": false + }, + "_links": [ + { + "rel": "parent", + "href": "https://us2.api.mailchimp.com/3.0/campaigns", + "method": "GET", + "targetSchema": "https://us2.api.mailchimp.com/schema/3.0/Definitions/Campaigns/CollectionResponse.json", + "schema": "https://us2.api.mailchimp.com/schema/3.0/Paths/Campaigns/Collection.json" + } + ] +} +``` -For Apikey authorization: -* Mailchimp account -* Mailchimp API key +**[Email Activity](https://mailchimp.com/developer/marketing/api/email-activity-reports/) Stream** -For OAuth authorization: -* Mailchimp registered app -* Mailchimp client_id -* Mailchimp client_secret +``` +{ + "campaign_id": "q1w2q1w2q1w2", + "list_id": "123qwe", + "list_is_active": true, + "email_id": "qwerty123456", + "email_address": "email@email.com", + "_links": [ + { + "rel": "parent", + "href": "https://us2.api.mailchimp.com/3.0/reports/q1w2q1w2q1w2/email-activity", + "method": "GET", + "targetSchema": "https://us2.api.mailchimp.com/schema/3.0/Definitions/Reports/EmailActivity/CollectionResponse.json" + } + ], + "action": "open", + "timestamp": "2020-10-08T22:15:43+00:00", + "ip": "00.000.00.5" +} +``` + +## Connector-specific features & highlights -### Setup guide +There is `id` primary key for `Lists` and `Campaigns` streams. +`Email Activity` hasn't primary key due to Mailchimp does not give it. -To start syncing Mailchimp data with Airbyte, you'll need to retrieve credentials. -According to the requirements you can use an API key or OAuth2.0 application. +## Data type mapping -If you want to use an API key, please follow these Mailchimp steps: -* [Create account](https://mailchimp.com/developer/marketing/guides/quick-start/#create-an-account) -* [Generate API key](https://mailchimp.com/developer/marketing/guides/quick-start/#generate-your-api-key) +| Integration Type | Airbyte Type | Notes | +| :--- | :--- | :--- | +| `array` | `array` | the type of elements in the array is determined based on the mappings in this table | +| `date`, `time`, `datetime` | `string` | | +| `int`, `float`, `number` | `number` | | +| `object` | `object` | properties within objects are mapped based on the mappings in this table | +| `string` | `string` | | -If you want to use [OAuth2.0](https://mailchimp.com/developer/marketing/guides/access-user-data-oauth-2/) creds, -please [register your application](https://mailchimp.com/developer/marketing/guides/access-user-data-oauth-2/#register-your-application). +## Tutorials +Now that you have set up the Mailchimp source connector, check out the following Mailchimp tutorial: +* [Build a data ingestion pipeline from Mailchimp to Snowflake](https://airbyte.com/tutorials/data-ingestion-pipeline-mailchimp-snowflake) ## Changelog | Version | Date | Pull Request | Subject | |:--------|:-----------|:---------------------------------------------------------|:-------------------------------------------------------------------------| +| 0.2.14 | 2022-04-12 | [11352](https://github.com/airbytehq/airbyte/pull/11352) | Update documentation | | 0.2.13 | 2022-04-11 | [11632](https://github.com/airbytehq/airbyte/pull/11632) | Add unit tests | | 0.2.12 | 2022-03-17 | [10975](https://github.com/airbytehq/airbyte/pull/10975) | Fix campaign's stream normalization | | 0.2.11 | 2021-12-24 | [7159](https://github.com/airbytehq/airbyte/pull/7159) | Add oauth2.0 support | From 676aa3f68d6f4ae5382cc43c330965e1b1ecea1b Mon Sep 17 00:00:00 2001 From: Anna Lvova <37615075+annalvova05@users.noreply.github.com> Date: Tue, 19 Apr 2022 14:44:11 +0300 Subject: [PATCH 05/13] Update docs/integrations/sources/mailchimp.md Co-authored-by: Andy --- docs/integrations/sources/mailchimp.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/integrations/sources/mailchimp.md b/docs/integrations/sources/mailchimp.md index cd0407508118..6767e1099433 100644 --- a/docs/integrations/sources/mailchimp.md +++ b/docs/integrations/sources/mailchimp.md @@ -4,7 +4,7 @@ This page guides you through the process of setting up the Mailchimp source conn ## Prerequisites -For Apikey authorization: +For API Key authorization: * Mailchimp account * Mailchimp API key From ebaaa573b84a019ba82969719c4186b07db3b6ce Mon Sep 17 00:00:00 2001 From: Anna Lvova <37615075+annalvova05@users.noreply.github.com> Date: Tue, 19 Apr 2022 14:44:38 +0300 Subject: [PATCH 06/13] Update docs/integrations/sources/mailchimp.md Co-authored-by: Andy --- docs/integrations/sources/mailchimp.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/integrations/sources/mailchimp.md b/docs/integrations/sources/mailchimp.md index 6767e1099433..513234d92221 100644 --- a/docs/integrations/sources/mailchimp.md +++ b/docs/integrations/sources/mailchimp.md @@ -10,7 +10,7 @@ For API Key authorization: For OAuth2.0 authorization: * Mailchimp registered app -* Mailchimp client_id +* Mailchimp `client_id` * Mailchimp client_secret ## Step 1: Set up Source From ef225c3e238fd0fc4e775032672f073750252fe4 Mon Sep 17 00:00:00 2001 From: Anna Lvova <37615075+annalvova05@users.noreply.github.com> Date: Tue, 19 Apr 2022 14:44:44 +0300 Subject: [PATCH 07/13] Update docs/integrations/sources/mailchimp.md Co-authored-by: Andy --- docs/integrations/sources/mailchimp.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/integrations/sources/mailchimp.md b/docs/integrations/sources/mailchimp.md index 513234d92221..99108b85e8a8 100644 --- a/docs/integrations/sources/mailchimp.md +++ b/docs/integrations/sources/mailchimp.md @@ -11,7 +11,7 @@ For API Key authorization: For OAuth2.0 authorization: * Mailchimp registered app * Mailchimp `client_id` -* Mailchimp client_secret +* Mailchimp `client_secret` ## Step 1: Set up Source From 266c29ab6d6c6d6eeb1fec4c6d08fc6e5aa3aad4 Mon Sep 17 00:00:00 2001 From: Anna Lvova <37615075+annalvova05@users.noreply.github.com> Date: Tue, 19 Apr 2022 14:45:02 +0300 Subject: [PATCH 08/13] Update docs/integrations/sources/mailchimp.md Co-authored-by: Andy --- docs/integrations/sources/mailchimp.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/integrations/sources/mailchimp.md b/docs/integrations/sources/mailchimp.md index 99108b85e8a8..c7c2f8b77344 100644 --- a/docs/integrations/sources/mailchimp.md +++ b/docs/integrations/sources/mailchimp.md @@ -27,7 +27,7 @@ please [register](https://mailchimp.com/developer/marketing/guides/access-user-d your Mailchimp account. 2. [Log into your Airbyte Cloud](https://cloud.airbyte.io/workspaces) account. 3. In the left navigation bar, click **Sources**. In the top-right corner, click **+ new source**. -4. On the Set up the source page, enter the name for the Mailchimp connector and select **Mailchimp** from the Source type dropdown. +4. On the source setup page, elect **Mailchimp** from the Source type dropdown and enter a name for this connector. 5. Select `OAuth2.0` Authorization method, then click `Authenticate your account`. 6. Log in and Authorize to the Mailchimp account and click `Set up source`. From d0915801ede568d81347fdad23fec3d23cdf65c2 Mon Sep 17 00:00:00 2001 From: Anna Lvova <37615075+annalvova05@users.noreply.github.com> Date: Tue, 19 Apr 2022 14:45:35 +0300 Subject: [PATCH 09/13] Update docs/integrations/sources/mailchimp.md Co-authored-by: Andy --- docs/integrations/sources/mailchimp.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/integrations/sources/mailchimp.md b/docs/integrations/sources/mailchimp.md index c7c2f8b77344..82a12fbecb9f 100644 --- a/docs/integrations/sources/mailchimp.md +++ b/docs/integrations/sources/mailchimp.md @@ -33,7 +33,7 @@ your Mailchimp account. **For Airbyte OSS:** -1. For using an API key [create account](https://mailchimp.com/developer/marketing/guides/quick-start/#create-an-account) +1. For using an API key, [create an account](https://mailchimp.com/developer/marketing/guides/quick-start/#create-an-account) in Mailchimp. 2. [Generate](https://mailchimp.com/developer/marketing/guides/quick-start/#generate-your-api-key) API key. 3. Go to local Airbyte page. From baf4bb55ff2b080af89481c2f8aa426dd77e2062 Mon Sep 17 00:00:00 2001 From: Anna Lvova <37615075+annalvova05@users.noreply.github.com> Date: Tue, 19 Apr 2022 14:47:36 +0300 Subject: [PATCH 10/13] Update docs/integrations/sources/mailchimp.md Co-authored-by: Andy --- docs/integrations/sources/mailchimp.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/integrations/sources/mailchimp.md b/docs/integrations/sources/mailchimp.md index 82a12fbecb9f..5f82f35fad85 100644 --- a/docs/integrations/sources/mailchimp.md +++ b/docs/integrations/sources/mailchimp.md @@ -49,7 +49,7 @@ The Mailchimp source connector supports the following [sync modes](https://docs. - Full Refresh - Incremental -We don't support Incremental Deletes for `Campaigns`, `Lists`, and `Email Activity` streams. +We don't support Incremental Deletes for `Campaigns`, `Lists`, and `Email Activity` streams because Mailchimp doesn't give any information about deleted data in these streams. ## Performance considerations From 4f6f2b4bdc221868f9cd2df14ee8a2229d229767 Mon Sep 17 00:00:00 2001 From: annalvova Date: Tue, 19 Apr 2022 14:57:45 +0300 Subject: [PATCH 11/13] update doc --- docs/integrations/sources/mailchimp.md | 8 ++++---- 1 file changed, 4 insertions(+), 4 deletions(-) diff --git a/docs/integrations/sources/mailchimp.md b/docs/integrations/sources/mailchimp.md index 5f82f35fad85..c6cae53c2be3 100644 --- a/docs/integrations/sources/mailchimp.md +++ b/docs/integrations/sources/mailchimp.md @@ -27,7 +27,7 @@ please [register](https://mailchimp.com/developer/marketing/guides/access-user-d your Mailchimp account. 2. [Log into your Airbyte Cloud](https://cloud.airbyte.io/workspaces) account. 3. In the left navigation bar, click **Sources**. In the top-right corner, click **+ new source**. -4. On the source setup page, elect **Mailchimp** from the Source type dropdown and enter a name for this connector. +4. On the source setup page, select **Mailchimp** from the Source type dropdown and enter a name for this connector. 5. Select `OAuth2.0` Authorization method, then click `Authenticate your account`. 6. Log in and Authorize to the Mailchimp account and click `Set up source`. @@ -45,12 +45,12 @@ in Mailchimp. ## Supported sync modes -The Mailchimp source connector supports the following [sync modes](https://docs.airbyte.com/getting-started-with-airbyte-cloud/core-concepts#connection-sync-modes): +The Mailchimp source connector supports the following [sync modes](https://docs.airbyte.com/cloud/core-concepts/#connection-sync-mode): - Full Refresh - Incremental -We don't support Incremental Deletes for `Campaigns`, `Lists`, and `Email Activity` streams because -Mailchimp doesn't give any information about deleted data in these streams. +We don't support Incremental Deletes for `Campaigns`, `Lists`, and `Email Activity` streams because +the Mailchimp doesn't give any information about deleted data in these streams. ## Performance considerations From e9b0baaf0dba6a3a2b54aa38d0cebeea4a17b678 Mon Sep 17 00:00:00 2001 From: Anna Lvova <37615075+annalvova05@users.noreply.github.com> Date: Thu, 21 Apr 2022 13:40:29 +0300 Subject: [PATCH 12/13] Update docs/integrations/sources/mailchimp.md Co-authored-by: Andy --- docs/integrations/sources/mailchimp.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/integrations/sources/mailchimp.md b/docs/integrations/sources/mailchimp.md index c6cae53c2be3..2fd0744aab17 100644 --- a/docs/integrations/sources/mailchimp.md +++ b/docs/integrations/sources/mailchimp.md @@ -13,7 +13,7 @@ For OAuth2.0 authorization: * Mailchimp `client_id` * Mailchimp `client_secret` -## Step 1: Set up Source +## Step 1: Set up Mailchimp [Log in](https://login.mailchimp.com/) to Mailchimp account. If you don't have a Mailchimp account already, you’ll need to [create](https://login.mailchimp.com/signup/) one in order to use the API. From 73ec29f5e5974e3d7539bb70957f76d56ec5683a Mon Sep 17 00:00:00 2001 From: Octavia Squidington III Date: Thu, 21 Apr 2022 11:53:35 +0000 Subject: [PATCH 13/13] auto-bump connector version --- .../init/src/main/resources/seed/source_definitions.yaml | 2 +- airbyte-config/init/src/main/resources/seed/source_specs.yaml | 4 ++-- 2 files changed, 3 insertions(+), 3 deletions(-) diff --git a/airbyte-config/init/src/main/resources/seed/source_definitions.yaml b/airbyte-config/init/src/main/resources/seed/source_definitions.yaml index 455cfcd48e10..6636f0274bbd 100644 --- a/airbyte-config/init/src/main/resources/seed/source_definitions.yaml +++ b/airbyte-config/init/src/main/resources/seed/source_definitions.yaml @@ -438,7 +438,7 @@ - name: Mailchimp sourceDefinitionId: b03a9f3e-22a5-11eb-adc1-0242ac120002 dockerRepository: airbyte/source-mailchimp - dockerImageTag: 0.2.13 + dockerImageTag: 0.2.14 documentationUrl: https://docs.airbyte.io/integrations/sources/mailchimp icon: mailchimp.svg sourceType: api diff --git a/airbyte-config/init/src/main/resources/seed/source_specs.yaml b/airbyte-config/init/src/main/resources/seed/source_specs.yaml index 186918a32be3..188311e67478 100644 --- a/airbyte-config/init/src/main/resources/seed/source_specs.yaml +++ b/airbyte-config/init/src/main/resources/seed/source_specs.yaml @@ -4492,7 +4492,7 @@ supportsNormalization: false supportsDBT: false supported_destination_sync_modes: [] -- dockerImage: "airbyte/source-mailchimp:0.2.13" +- dockerImage: "airbyte/source-mailchimp:0.2.14" spec: documentationUrl: "https://docs.airbyte.io/integrations/sources/mailchimp" connectionSpecification: @@ -4504,7 +4504,7 @@ properties: credentials: type: "object" - title: "Authentication Method" + title: "Authentication *" oneOf: - title: "OAuth2.0" type: "object"