If you’re not already an Iterable client, request a demo to discuss how the Iterable and Stitch Data integration can work for you.
Table of contents
Add Iterable as a Stitch Data Source
Sign in to your Stitch account.
On the Stitch Dashboard page, click the Add Integration button.
Click the Iterable icon.
Enter a name for the integration.
- This is the name that will display on the Stitch Dashboard for the integration; it’ll also be used to create the schema in your destination. For example, the name “Stitch Iterable” would create a schema called stitch_iterable in the destination.
Schema names cannot be changed after you save the integration.
Click Save Integration.
Generate an Iterable webhook URL
Once Stitch has successfully saved and created the Iterable integration, you’ll be redirected to a page that displays your Iterable webhook URL and token (which is blurred in the image below):
Click the Copy button to copy it.
Note that this particular URL won’t display in Stitch again once you click Continue. Think of this URL like you would your login or API credentials: keep it secret, keep it safe. You can, however, generate another URL should you need it.
Once you’ve copied your webhook URL, click Continue to wrap things up in Stitch.
Set up webhooks in Iterable
The last step is to set up webhooks in your Iterable account.
Sign into your Iterable account.
Click Integrations > System Webhooks.
In the Endpoint field, paste your Stitch-generated webhook URL.
Click Create Webhook.
After the webhook is saved, click the Edit button on the far right to select the events you want to track.
Check the events you want to track:
Your changes will save automatically. You’re good to go.
After you’ve successfully connected your Iterable integration, Stitch will continuously replicate your webhook data into your data warehouse.
Webhooks and historical data
Because Iterable data is sent to Stitch in real-time, this means that only new records are replicated to your data warehouse. Most webhook-based integrations don’t retain historical data due to this as-it-happens approach.
In the event that our webhook service experiences downtime, you may notice some lag between an event occurring and the data appearing in your data warehouse.
This version of Stitch’s Iterable integration uses append-only replication. Append-only replication is a type of incremental replication where newly replicated data is appended to the end of a table. Existing rows are not updated; updates are added to the end of the table as new rows. Data stored this way can provide insights and historical details about how those rows have changed over time.
Query for the latest data
If you simply want the latest version of the object—or objects, if you
elected to track more than one during the setup—in the integration’s table
(data), you’ll have to adjust your querying strategy to account for the
append-only method of replication. This is a little different than querying
records that are updated using
updated_at incremental replication.
To do this, you can use the
_sdc_sequence column and the table’s primary key.
_sdc_sequence is a Unix epoch (down to the millisecond) attached to the
record during replication and can help determine the order of all the
versions of a row.
If you didn’t define a primary key while setting up the integration,
the primary key for the table will be
If you want to create a snapshot of the latest version of this table, you could run a query like this:
SELECT * FROM [stitch-redshift:stitch-iterable.data] o INNER JOIN ( SELECT MAX(_sdc_sequence) AS seq, [primary-key] FROM [stitch-redshift:stitch-iterable.data] GROUP BY [primary-key]) oo ON o.[primary-key] = oo.[primary-key] AND o._sdc_sequence = oo.seq
This approach uses a subquery to get a single list of every row’s primary key and maximum sequence number. It then joins the original table to both the primary key and maximum sequence, which makes all other column values available for querying.
In v1 of the stitch incoming webhooks integration, Stitch will create a single table—called data—in the webhook integration schema (this will be the name you enter in the Integration Schema field when you set up Iterable) of your data warehouse.
The schema of this table will contain two “types” of columns:
- Columns used by Stitch (prepended with
- Columns sent by the provider’s webhook API
Aside from the Stitch columns, the schema of this table will depend entirely
on Iterable’s webhook API. With the exception of the
_sdc fields, Stitch does
not augment incoming webhooks data nor does it have any control over the
fields sent by the webhook provider.
Webhook URLs & security
Stitch allows you to generate up to two Iterable webhook URLs at a time. These URLs contain security access tokens and as such, have access to your Iterable account.
If you ever need to change your webhook URL, you can do so in the Integration Settings page after the integration has been created:
Click into the integration from the Stitch Dashboard page.
Click the Settings button.
In the Webhook URLs section, click the Generate Webhook URL button.
A new webhook URL will display. Press the clipboard icon to copy it.
Follow the steps in the set up webhooks in Iterable section to update the webhook URL in Iterable.
After you’ve updated the webhook URL in Iterable, click the Revoke button next to the oldest webhook URL in Stitch. This will invalidate the token and revoke access.