Iterable
This page contains the setup guide and reference information for the Iterable source connector.
Prerequisites
To set up the Iterable source connector, you'll need the Iterable Server-side
API Key with standard
permissions.
Set up the Iterable connector in Airbyte
- Log into your Airbyte Cloud account or navigate to the Airbyte Open Source dashboard.
- Click Sources and then click + New source.
- On the Set up the source page, select Iterable from the Source type dropdown.
- Enter the name for the Iterable connector.
- For API Key, enter the Iterable API key.
- For Start Date, enter the date in YYYY-MM-DDTHH:mm:ssZ format. The data added on and after this date will be replicated.
- Click Set up source.
Supported sync modes
The Iterable source connector supports the following sync modes:
Supported Streams
- Campaigns
- Campaign Metrics
- Channels
- Email Bounce (Incremental)
- Email Click (Incremental)
- Email Complaint (Incremental)
- Email Open (Incremental)
- Email Send (Incremental)
- Email Send Skip (Incremental)
- Email Subscribe (Incremental)
- Email Unsubscribe (Incremental)
- Events
- Lists
- List Users
- Message Types
- Metadata
- Templates (Incremental)
- Users (Incremental)
- PushSend (Incremental)
- PushSendSkip (Incremental)
- PushOpen (Incremental)
- PushUninstall (Incremental)
- PushBounce (Incremental)
- WebPushSend (Incremental)
- WebPushClick (Incremental)
- WebPushSendSkip (Incremental)
- InAppSend (Incremental)
- InAppOpen (Incremental)
- InAppClick (Incremental)
- InAppClose (Incremental)
- InAppDelete (Incremental)
- InAppDelivery (Incremental)
- InAppSendSkip (Incremental)
- InboxSession (Incremental)
- InboxMessageImpression (Incremental)
- SmsSend (Incremental)
- SmsBounce (Incremental)
- SmsClick (Incremental)
- SmsReceived (Incremental)
- SmsSendSkip (Incremental)
- SmsUsageInfo (Incremental)
- Purchase (Incremental)
- CustomEvent (Incremental)
- HostedUnsubscribeClick (Incremental)
Additional notes
List Users Stream when meet 500 - Generic Error
will skip a broken slice and keep going with the next one. This is related to unexpected failures when trying to get users list for specific list ids. See #24968 issue for more details.
Reference
Config fields reference
Field
Type
Property name
string
api_key
string
start_date
Changelog
Expand to review
Version | Date | Pull Request | Subject |
---|---|---|---|
0.5.3 | 2024-06-05 | 39142 | Updated the CDK version to 0.89.0 to fix OOM |
0.5.2 | 2024-06-04 | 39077 | [autopull] Upgrade base image to v1.2.1 |
0.5.1 | 2024-04-24 | 36645 | Schema descriptions and CDK 0.80.0 |
0.5.0 | 2024-03-18 | 36231 | Migrate connector to low-code |
0.4.0 | 2024-03-19 | 36267 | Pin airbyte-cdk version to ^0 |
0.3.0 | 2024-02-20 | 35465 | Per-error reporting and continue sync on stream failures |
0.2.2 | 2024-02-12 | 35150 | Manage dependencies with Poetry. |
0.2.1 | 2024-01-12 | 1234 | prepare for airbyte-lib |
0.2.0 | 2023-09-29 | 28457 | Added userId to email_bounce , email_click , email_complaint , email_open , email_send email_send_skip , email_subscribe , email_unsubscribe , events streams |
0.1.31 | 2023-12-06 | 33106 | Base image migration: remove Dockerfile and use the python-connector-base image |
0.1.30 | 2023-07-19 | 28457 | Fixed TypeError for StreamSlice in debug mode |
0.1.29 | 2023-05-24 | 26459 | Added requests reading timeout 300 seconds |
0.1.28 | 2023-05-12 | 26014 | Improve 500 handling for Events stream |
0.1.27 | 2023-04-06 | 24962 | UserList stream when meet 500 - Generic Error will skip a broken slice and keep going with the next one |
0.1.26 | 2023-03-10 | 23938 | Improve retry for 500 - Generic Error |
0.1.25 | 2023-03-07 | 23821 | Added retry for 500 - Generic Error , increased max attempts number to 6 to handle ChunkedEncodingError |
0.1.24 | 2023-02-14 | 22979 | Specified date formatting in specification |
0.1.23 | 2023-01-27 | 22011 | Set AvailabilityStrategy for streams explicitly to None |
0.1.22 | 2022-11-30 | 19913 | Replace pendulum.parse -> dateutil.parser.parse to avoid memory leak |
0.1.21 | 2022-10-27 | 18537 | Improve streams discovery |
0.1.20 | 2022-10-21 | 18292 | Better processing of 401 and 429 errors |
0.1.19 | 2022-10-05 | 17602 | Add check for stream permissions |
0.1.18 | 2022-10-04 | 17573 | Limit time range for SATs |
0.1.17 | 2022-09-02 | 16067 | added new events streams |
0.1.16 | 2022-08-15 | 15670 | Api key is passed via header |
0.1.15 | 2021-12-06 | 8524 | Update connector fields title/description |
0.1.14 | 2021-12-01 | 8380 | Update Events stream to use export/userEvents endpoint |
0.1.13 | 2021-11-22 | 8091 | Adjust slice ranges for email streams |
0.1.12 | 2021-11-09 | 7780 | Split EmailSend stream into slices to fix premature connection close error |
0.1.11 | 2021-11-03 | 7619 | Bugfix type error while incrementally loading the Templates stream |
0.1.10 | 2021-11-03 | 7591 | Optimize export streams memory consumption for large requests |
0.1.9 | 2021-10-06 | 5915 | Enable campaign_metrics stream |
0.1.8 | 2021-09-20 | 5915 | Add new streams: campaign_metrics, events |
0.1.7 | 2021-09-20 | 6242 | Updated schema for: campaigns, lists, templates, metadata |