The Swym + Iterable integration lets you deliver personalized and timely lifecycle marketing campaigns based on real-time shopper intent data from Swym. When shoppers interact with Swym features like Wishlist and Save for Later, their activity is captured and sent to Iterable. You can use this data to automatically send personalized, contextualized messages at the right moment — helping you boost customer engagement, recover lost sales opportunities, and drive repeat purchases.
There are three steps to set up this integration:
Connect your Swym app to Iterable — Establish the connection so that your Swym Wishlist Plus or Back in Stock Alerts app can securely communicate with Iterable.
Subscribe to the events you want to send — Choose which Swym events (for example, price drops, back in stock alerts, or wishlist reminders) should be sent to Iterable.
Set up journeys — Set up journeys that use your subscribed events as triggers to send personalized messages to your shoppers.
NOTE
It's a common mistake to stop after Step 1, but if you don't subscribe to Swym events or build journeys that use those events as triggers to send messages, users won't receive updates about the products they've expressed interest in. Make sure you complete all three setup steps to ensure the integration works as intended.
# In this article
# Requirements
To set up this integration, you need the following:
- An active Swym account with the Enterprise plan for Wishlist Plus or Back in Stock Alerts
- An Iterable server-side API key
# Step 1: Connect Swym to Iterable
# In Iterable
To create an API key, go to Integrations > API Keys.
See Creating API Keys for detailed instructions on how to create, name, and store the API keys you need for authenticating with Iterable's partner platforms.
# In Swym
Open your Shopify admin dashboard, and go to Apps > Wishlist Plus > Integrations.
-
Find the Iterable tile and click Connect.
-
Enter the Iterable API key you created in the previous step.
Click Connect.
# Step 2: Subscribe to events
From your Swym Wishlist Plus or Back In Stock Alerts app, go to the Marketing tab and scroll to the Automations section. Here, you will see various events that you can subscribe to. Select your desired events.
The following events are supported for the Wishlist Plus app:
| Event name | When this event is triggered |
|---|---|
| Wishlist Reminder | Reminder about items in a shopper's wishlist |
| Saved for Later Reminder | Reminder about a shopper's Saved for Later items |
| Price Drop Alert | Product on a wishlist goes on sale |
| Low Stock Alert | Product on a wishlist is running low on stock |
| Back in Stock Alert | Product on a wishlist is restocked |
The following events are supported for the Back in Stock Alerts app:
| Event name | When this event is triggered |
|---|---|
| Back in Stock Acknowledgement | Shopper subscribes to be notified when a product is back in stock |
| Restock Alert | Product a shopper requested a back-in-stock alert for is restocked |
| Restock Reminder | Follow-up alert (usually ~24 hrs after the first restock alert, configurable) |
# Step 3: Build Iterable journeys
Once you've subscribed to the events you wish to use for this integration, you need to build Iterable journeys that use those triggers to send timely updates to users about the products they've expressed interest in.
NOTE
Since a journey can only have one trigger, you'll need to build a separate journey for each Swym event you've subscribed to.
In Iterable, go to Messaging > Journeys, and click New journey.
-
The journey's Start tile determines how the journey is triggered. Open the Start tile, select the Event Occurs entry source, then under Entry Type select Custom Event. Under Specify Event, select the custom event that corresponds to the Swym event you want to use as the journey's trigger (for example,
Swym-addedtowishlist). Add an Email or SMS tile, and create or attach the campaign you wish to send to users when they're added to the journey via your selected Swym event trigger. See Message Tiles to learn more about adding and configuring Email and SMS tiles in journeys.
-
If desired, personalize the content of the email or SMS template with Handlebars
syntax. Handlebars variables (for example, {{productName}}) let you pull in customer-specific or event-specific data in message templates. These variables are replaced at send time with customer data from the events that Swym sends. See Supported event variables for a full list of variables that can be pulled into message templates with this integration.To learn more about using Handlebars to personalize message templates, see Handlebars Overview
.
- Finish configuring the journey with your desired steps, then save and publish the journey when you're ready for users to start being added to it.
To learn more about building and managing journeys in Iterable, see Journey Building Overview.
# Supported event variables
The following sections describe the variables available for each Swym event type.
# Wishlist Reminder
Custom event name: Swym-addedtowishlist
| Variable | Details |
|---|---|
productCount | Number of products in the current wishlist reminder event |
products[] | List of products. Each element in the products list has the following fields: |
products[].imageURL | URL of product's image |
products[].variantInfo | Variant info or name if the product has any variants |
products[].productCurrentPrice | Product's price |
products[].productBrand | Brand name of the product (if any) |
products[].productQuantity | Number of products wishlisted |
products[].productName | Name of the product added to wishlist |
products[].productCategory | Category of the product |
products[].productURL | URL directing to the PDP |
# Saved for Later Reminder
Custom event name: Swym-addedtosfl
| Variable | Details |
|---|---|
productCount | Number of products in the current reminder event |
products[] | List of products. Each element in the products list has the following fields: |
products[].imageURL | URL of product's image |
products[].variantInfo | Variant info or name if the product has any variants |
products[].productCurrentPrice | Product's price |
products[].productBrand | Brand name of the product (if any) |
products[].productQuantity | Number of products saved for later |
products[].productName | Name of the product saved for later |
products[].productCategory | Category of the product |
products[].productURL | URL directing to the PDP |
# Low Stock Alert
Custom event name: Swym-lowstock
| Variable | Details |
|---|---|
imageURL | URL of product's image |
productName | Name of the product |
variantInfo | Variant info or name if the product has any variants |
productCurrentPrice | Product's price |
productURL | URL directing to the PDP |
productCategory | Category of the product |
productQuantity | Number of products left in the inventory |
productBrand | Brand name of the product (if any) |
# Price Drop Alert
Custom event name: Swym-pricedrop
| Variable | Details |
|---|---|
imageURL | URL of product's image |
productName | Name of the product added to wishlist |
variantInfo | Variant info or name if the product has any variants |
productOriginalPrice | Product's initial price before drop (compare at price) |
productCurrentPrice | Product's current price |
productURL | URL directing to the PDP |
productCategory | Category of the product |
productQuantity | Number of products left in the inventory |
productBrand | Brand name of the product (if any) |
# Back in Stock Alert
Custom event name: Swym-backinstock
| Variable | Details |
|---|---|
imageURL | URL of product's image |
productName | Name of the product added to wishlist |
variantInfo | Variant info or name if the product has any variants |
productCurrentPrice | Product's price |
productURL | URL directing to the PDP |
productCategory | Category of the product |
productQuantity | Number of products left in the inventory |
productBrand | Brand name of the product (if any) |
# Restock Reminder
Custom event name: Swym-backinstockReminder
| Variable | Details |
|---|---|
imageURL | URL of product's image |
productName | Name of the product added to wishlist |
variantInfo | Variant info or name if the product has any variants |
productCurrentPrice | Product's price |
productURL | URL directing to the PDP |
productCategory | Category of the product |
productQuantity | Number of products left in the inventory |
productBrand | Brand name of the product (if any) |
# Back in Stock Acknowledgement
Custom event name: Swym-remindMe
| Variable | Details |
|---|---|
imageURL | URL of product's image |
productName | Name of the product subscribed to |
variantInfo | Variant info or name if the product has any variants |
productCurrentPrice | Product's price |
productURL | URL directing to the PDP |
productCategory | Category of the product |
productQuantity | Number of products left in the inventory |
productBrand | Brand name of the product (if any) |
# Troubleshooting
# Testing the connection
You can verify that this integration's connection is working by sending test triggers to Iterable from Swym.
In your Swym Wishlist Plus app, go to the Iterable integration page.
Under Test Integration, select the test event(s) you'd like to send to Iterable.
Enter a valid email address or phone number that you have access to for testing purposes.
Click Send Test Triggers.
Once the trigger(s) have been sent, sign in to your Iterable account and go to Messaging > Journeys.
Create or open a journey, and open the Start tile to edit it.
Select the Event Occurs entry source, then under Entry Type select Custom Event.
Open the Specify Event dropdown, and you should see the test events available to select.
If the Swym events you subscribed to appear there, it confirms that your Swym app is successfully communicating with your Iterable account.
# Verifying events are reaching Iterable
To verify that events from Swym are syncing to Iterable, go to Insights > Logs > Events. The Raw Data column shows what data is sent from the Swym app for the corresponding event.
# Verifying that messages are being sent
To verify if the messages are being properly rendered and sent, go to Insights > Logs > Sent Messages.
# Need help?
Have questions or need help getting set up? Reach out to the Swym support team for assistance.