iterable.md

Iterable

This page contains the setup guide and reference information for the Iterable source connector.

Prerequisites

• Iterable Account
• Iterable Server-side API Key with standard permissions. See API Keys docs for more details.

Setup guide

Step 1: Set up Iterable

• Please read How to find your API key.
• Make sure that selected API Key has sufficient permissions to read all selected streams.

Step 2: Set up the Iterable connector in Airbyte

For Airbyte Cloud:

1. Log into your Airbyte Cloud account.
2. In the left navigation bar, click Sources. In the top-right corner, click +new source.
3. On the Set up the source page, enter the name for the Iterable connector and select Iterable from the Source type dropdown.
4. Enter your api_key
5. Enter the start_date you want your sync to start from
6. Click Set up source

For Airbyte OSS:

1. Navigate to the Airbyte Open Source dashboard
2. Set the name for your source
3. Enter your api_key
4. Enter the start_date you want your sync to start from
5. Click Set up source

Supported sync modes

The Iterable source connector supports the following sync modes:

Feature	Supported?
Full Refresh Sync	Yes
Incremental Sync	Yes
SSL connection	Yes

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)

Changelog

Version	Date	Pull Request	Subject
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