--- title: "Integrating Yotpo Loyalty & Referrals with Retention Science" slug: "integrating-yotpo-loyalty-referrals-with-retention-science" tags: ["Adobe Commerce (Magento)", "BigCommerce", "Custom", "Loyalty and Referrals", "Salesforce Commerce Cloud", "Shopify", "Shopify Plus"] updated: 2025-07-22T14:20:33Z published: 2025-07-22T14:20:33Z canonical: "support.yotpo.com/integrating-yotpo-loyalty-referrals-with-retention-science" --- > ## Documentation Index > Fetch the complete documentation index at: https://support.yotpo.com/llms.txt > Use this file to discover all available pages before exploring further. # Integrating Yotpo Loyalty & Referrals with Retention Science Products Loyalty ###### Supported plans Premium, Enterprise ###### eCommerce Platform Shopify, Shopify Plus, Adobe Commerce (Magento), BigCommerce, Salesforce Commerce Cloud, Custom ![](https://cdn.document360.io/f3c2ab59-fe4c-4f93-9614-2872f40e8aa7/Images/Documentation/e88e4344-a600-41a9-96bd-78d45a540313.png?sv=2026-02-06&spr=https&st=2026-10-28T03%3A41%3A48Z&se=2026-10-28T04%3A41%3A48Z&sr=c&sp=r&sig=SSJf5Op2vugOlzhgxh56HLePrFNvKaPU8gunkJCtNbg%3D) If you use **Retention Science** to send marketing emails to your customers, you can now use Yotpo Loyalty & Referrals' integration with Retention Science to pass program-related data directly into your Retention Science account! Sending rewards and referral program-related emails directly from Retention Science makes it easier to manage your marketing drips, ensure that customers receive the right email at the right time, and better target customers based on their program status. ## Before You Start Before we can get started with setting up your integration, you will need to **contact your Retention Science rep** with regards to key elements needed for set-up: - Request to enable the Swell Plugin - Request your API key Note **Retention Science Integration Center.** Once the Integration Center is launched you'll be able to enable your Swell plugin, access your API key, and view your customer attributes without the assistance of a ReSci rep. 1. Log in to your **Yotpo Loyalty & Referrals admin**. 2. In the left sidebar, go to **Integrations Center**. 3. Locate the **Retention Science** tile and click it. ![Retention Scients tile in Yotpo's Integrations center](https://cdn.document360.io/f3c2ab59-fe4c-4f93-9614-2872f40e8aa7/Images/Documentation/Resci-tile-integrations-center.png?sv=2026-02-06&spr=https&st=2026-10-28T03%3A41%3A48Z&se=2026-10-28T04%3A41%3A48Z&sr=c&sp=r&sig=SSJf5Op2vugOlzhgxh56HLePrFNvKaPU8gunkJCtNbg%3D) 4. Enter the **API Key** you received from your Retention Science rep and click **Connect** to start syncing your Yotpo Referrals customer attributes to ReSci: ![Retention Science - add API key pop-up](https://cdn.document360.io/f3c2ab59-fe4c-4f93-9614-2872f40e8aa7/Images/Documentation/resci-enter-API-key.png?sv=2026-02-06&spr=https&st=2026-10-28T03%3A41%3A48Z&se=2026-10-28T04%3A41%3A48Z&sr=c&sp=r&sig=SSJf5Op2vugOlzhgxh56HLePrFNvKaPU8gunkJCtNbg%3D) And you're all set! You'll see your sync has begun within that **Integration** section of your Yotpo Loyalty & Referrals admin. Note Once the Yotpo Loyalty & Referrals sync is completed in your Integrations section, it will take 24 hours to **view** that data in Retention Science, but functionality will be available immediately! ## Integration Data Once integrated with Retention Science, Yotpo Referrals shares customer **properties**, allowing you to create rich and effective email campaigns. **Properties** refer to any pertinent Yotpo Referrals data about the customer (e.g. point balance, unique referral link, vip tier, etc.). Each time it updates (for example, if a customer earns more points), Yotpo Referrals will automatically update it in Retention Science as well. The **merge tags** below are the tags available for you to use in any Yotpo Referrals-Retention Science emails you'd like to send to your customers, giving it a more personalized feel.Merge ****Tags**** - Points Balance - Points Earned - Referral Discount Code - Referral URL - Credit Balance - Has Account - Total Amount Earned - Affiliate Email - Has Provided Tax Details - Is Affiliate - Payout Percentage - Tier Name - Tier Multiplier - Tier Reward Points - Tier Amount Spent - Tier Amount Spent Cents - Tier Amount Spend Needed - Tier Amount Spend Needed Cents - Tier Points Earned - Tier Points Needed - Tier Purchases Made - Tier Purchases Needed - Tier Referrals Completed - Tier Referrals Needed - Tier Redemption Option Name - Next Tier Name - Next Tier Multiplier - Next Tier Reward Points - Next Tier Redemption Option Name - VIP Tier Ends At - Points Expire At ## Including Loyalty & Referrals Properties in Retention Science Emails Using your **properties** data, there's a wide variety of emails you can send using the Yotpo Referrals-Retention Science integration. This section describes a basic "how-to" on including those merge tags, as well as some of the most popular emails we recommend sending, and includes the email **merge tags** you'll need to place the appropriate program data in each email. #### How to build an email 1. Under the **Cortex** section of your Retention Science admin, click on **Emails** to get started. 2. Create a **New Email**in Cortex. 1. For more help on creating emails in Cortex, visit [this help article](https://help.retentionscience.com/hc/en-us/articles/115008000827-Setting-Up-Cortex-Stages) 3. **Select** and continue to the **HTML Editor.** ![](https://cdn.document360.io/f3c2ab59-fe4c-4f93-9614-2872f40e8aa7/Images/Documentation/158cf0fe-9bec-4233-a6ee-f6db33ba9527.png?sv=2026-02-06&spr=https&st=2026-10-28T03%3A41%3A48Z&se=2026-10-28T04%3A41%3A48Z&sr=c&sp=r&sig=SSJf5Op2vugOlzhgxh56HLePrFNvKaPU8gunkJCtNbg%3D) 1. Once you're in the HTML Editor, you'll be able to click on the **Insert Merge Tag** drop-down and see all the properties you can include under the Yotpo Referrals sub-section: ![](https://cdn.document360.io/f3c2ab59-fe4c-4f93-9614-2872f40e8aa7/Images/Documentation/518a93f2-87c2-4488-bd63-15093ffbc7c1.png?sv=2026-02-06&spr=https&st=2026-10-28T03%3A41%3A48Z&se=2026-10-28T04%3A41%3A48Z&sr=c&sp=r&sig=SSJf5Op2vugOlzhgxh56HLePrFNvKaPU8gunkJCtNbg%3D) #### Program-related emails Want to send customers an email with their referral link? Or include their up-to-the-minute point balance? No problem! #### Encourage customers to share their referral link We highly encourage you to send an email to your customers with their unique referral link. Upon receiving your email, they can forward it directly along to all of their friends, and hopefully earn you tons of referral-based business in the process! Wherever you'd like to include the customer's unique referral link in your email, here's some sample text that includes the merge tag you can paste directly into the **HTML Editor**: ```plaintext Want to earn even more rewards to our store? Send out your referral link, {{user.swell.referral_url}}, to your friends & family so they can take advantage of the 10% discount and you can get rewarded with a 10% discount too after they make their first purchase! ``` #### Update customers on their point balance In almost any of your emails, it's never a bad idea to update your customers on their point balance! Better yet, here's some sample text that includes the merge tag you can paste directly into the **HTML Editor**: ```plaintext You're really racking up on your points! At the moment you have {{user.swell.points_balance}} points. Refer back to your Rewards Program to see just how close you are to your next discount!:) ``` *These are just a few of the ways you can begin including your Yotpo Loyalty And Referrals program data within your Retention Science emails! If you have any other questions, please feel free to reach out to us or Retention Science's support team!*