--- title: "Integrating Yotpo Loyalty & Referrals with Dotdigital" slug: "integrating-yotpo-loyalty-referrals-with-dotdigital" tags: ["Adobe Commerce (Magento)", "BigCommerce", "Custom", "Loyalty and Referrals", "Salesforce Commerce Cloud", "Shopify", "Shopify Plus"] updated: 2026-03-25T12:47:56Z published: 2026-03-25T12:47:56Z canonical: "support.yotpo.com/integrating-yotpo-loyalty-referrals-with-dotdigital" --- > ## 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 Dotdigital Products Loyalty ###### Supported plans Premium, Enterprise ###### eCommerce Platform Shopify, Shopify Plus, Adobe Commerce (Magento), BigCommerce, Salesforce Commerce Cloud, Custom > [!NOTE] > Is this article for me? > > - This article is relevant if you’re using the [Dotdigital-built integration between Yotpo Loyalty & Referrals and Dotdigital](https://support.dotdigital.com/en/articles/12674501-integrate-yotpo-loyalty-with-dotdigital). > - If you’re using Yotpo’s legacy integration with Dotdigital, please contact [Dotdigital support](https://requests.dotdigital.com/hc/en-gb) and refer to their [migration guide](https://resources.dotdigital.com/view/613028225/i/). ## Integration Overview The integration allows you to sync loyalty data from Yotpo Loyalty & Referrals into your Dotdigital account. Once connected, you can: - Sync customer loyalty attributes (e.g., points balance, tier, referrals, birthday) - Segment contacts based on loyalty data - Trigger automated campaigns based on loyalty events - Personalize emails using loyalty data The connection is initiated from your Yotpo Loyalty admin, and the configuration is completed in Dotdigital. In this article, you’ll learn how to connect your Yotpo Loyalty & Referrals account to Dotdigital. ### Before You Begin Make sure you have access to your: - Yotpo Loyalty admin - Dotdigital admin - Yotpo App Key, API Key, and GUID during setup. You can [take your App Key here](https://support.yotpo.com/docs/finding-your-yotpo-app-key-and-secret-key), and your [API Key and GUID here](https://support.yotpo.com/docs/yotpo-api). ## Step 1: Connect Yotpo Loyalty & Referrals to Dotdigital (Yotpo admin) 1. In your Yotpo Loyalty admin, go to [**Integrations Center**](https://loyalty-app.yotpo.com/integrations-center)**.** 2. Locate the **Dotdigital for Yotpo Loyalty** tile and click to connect the integration. 3. Follow the **connection steps** on the screen. ![Yotpo Loyalty x Dotdigital connection steps, visual walkthrough](https://cdn.document360.io/f3c2ab59-fe4c-4f93-9614-2872f40e8aa7/Images/Documentation/dotdigital-topo-loyalty-connection.png?sv=2026-02-06&spr=https&st=2026-10-28T01%3A48%3A46Z&se=2026-10-28T02%3A48%3A46Z&sr=c&sp=r&sig=dAUUUIZ967XYfc5Ii8bczT1gMhNeE08sM3JNIcdsxJg%3D) 4. You will be taken to your Dotdigital admin to **complete the setup**. ## Step 2: Complete the Integration Setup (Dotdigital admin) 1. **Authorize the connection in Dotdigital** After connecting Yotpo Loyalty & Referrals to Dotdigital, you’ll be redirected to authorize the connection in Dotdigital. [Follow the steps here](https://support.dotdigital.com/en/articles/12674501-integrate-yotpo-loyalty-with-dotdigital#h_cee515db34) to complete the connection. 2. [**Configure the contact sync settings**](https://support.dotdigital.com/en/articles/12674501-integrate-yotpo-loyalty-with-dotdigital#h_1b5efd71ae) ![Contact Sync Settings Dotdigital](https://cdn.document360.io/f3c2ab59-fe4c-4f93-9614-2872f40e8aa7/Images/Documentation/contact-sync-settings.png?sv=2026-02-06&spr=https&st=2026-10-28T01%3A48%3A46Z&se=2026-10-28T02%3A48%3A46Z&sr=c&sp=r&sig=dAUUUIZ967XYfc5Ii8bczT1gMhNeE08sM3JNIcdsxJg%3D) Choose how contacts are synced: 1. Sync all Yotpo contacts, or 2. Update only existing Dotdigital contacts 3. [**Configure the loyalty opt-in preferences**](https://support.dotdigital.com/en/articles/12674501-integrate-yotpo-loyalty-with-dotdigital#h_a8159313fe) ![Contact Sync Preferences](https://cdn.document360.io/f3c2ab59-fe4c-4f93-9614-2872f40e8aa7/Images/Documentation/contact-sync-preferences-dotdigital.png?sv=2026-02-06&spr=https&st=2026-10-28T01%3A48%3A46Z&se=2026-10-28T02%3A48%3A46Z&sr=c&sp=r&sig=dAUUUIZ967XYfc5Ii8bczT1gMhNeE08sM3JNIcdsxJg%3D) Decide which customers are synced: 1. Only opted-in loyalty members, or 2. All customers (incl. non-opted users) 4. **Map your data fields** ![data field mapping](https://cdn.document360.io/f3c2ab59-fe4c-4f93-9614-2872f40e8aa7/Images/Documentation/datafield-mapping.png?sv=2026-02-06&spr=https&st=2026-10-28T01%3A48%3A46Z&se=2026-10-28T02%3A48%3A46Z&sr=c&sp=r&sig=dAUUUIZ967XYfc5Ii8bczT1gMhNeE08sM3JNIcdsxJg%3D) Choose **Yes** if you want to manually select and map specific data fields for your sync. Otherwise, default data field mappings will be used for your integration. 5. **(Optional)** [**Map your campaigns using loyalty events**](https://support.dotdigital.com/en/articles/12674501-integrate-yotpo-loyalty-with-dotdigital#h_1ea3e98420) ![Campaign mapping in Dotdigital](https://cdn.document360.io/f3c2ab59-fe4c-4f93-9614-2872f40e8aa7/Images/Documentation/campaign-mapping.png?sv=2026-02-06&spr=https&st=2026-10-28T01%3A48%3A46Z&se=2026-10-28T02%3A48%3A46Z&sr=c&sp=r&sig=dAUUUIZ967XYfc5Ii8bczT1gMhNeE08sM3JNIcdsxJg%3D) You can map Yotpo Loyalty & Referrals events to automated Campaigns and Programs in Dotdigital. When a selected event occurs in Yotpo, Dotdigital can automatically trigger a campaign. ## What Data Is Shared in the Integration ### Yotpo Loyalty & Referrals Customer Attributes | Attribute | Description | | --- | --- | | First name | Customer’s first name. | | Last name | Customer’s last name. | | Has_account | Whether the customer has a store account. | | Current_tier | Customer’s current tier name. | | Current_tier_ends | Date when the customer’s tier expires. | | Points_earned | Number of points earned. | | Amount_spent | Annual amount spent by the customer. | | Purchases_made | Number of purchases made by the customer. | | Referrals_completed | Number of completed referrals by the customer. | | Points_balance | Customer’s current points balance. | | Points_expire_at | Date when the customer’s points expire. | | Referral_code | Customer’s unique referral discount code. Only applicable to code-based referrals. | | Amount_needed | Amount needed to maintain the customer’s current tier. | | Purchases_needed | Purchases needed to maintain the customer’s current tier. | | Points_needed | Points needed to maintain the customer’s current tier. | | New_tier_multiplier | Points multiplier applied to the next tier that the customer could achieve. | | Nxtpts_expire | Date when a customer's points expire. | | Days_to_expiry | Number of days left before the points expire. | | Nxtpts_expire_amnt | Number of points that are about to expire. | | Next_pts_needed | Points needed to reach next tier. | | Next_amnt_needed | Amount needed to reach the next tier. | | Next_purch_needed | Number of purchases the customer must complete to reach the next tier. | | Next_refer_needed | Number of referrals the customer must make to reach the next tier. | | Birthday | Customer’s birthday. | | Reward_text | If a customer is gifted a coupon for their birthday reward, this is the coupon code. | | Reward_points | If a customer is gifted points for their birthday reward, this is how many points they were gifted. | | Referral_link | Customer’s unique referral link. | | Credit_balance | Current available credit balance (if points are displayed as credit based on your variable redemption reward settings). | | Payout_percent | Payout percentage set for this customer. Only populated if the customer is marked as an affiliate. | | Has_tax_details | - If the customer provided tax details for the influencer program and is marked as doing so in the Yotpo Loyalty admin, the value here is 1. - If they did not provide tax details, this is 0. Only populated if the customer is marked as an affiliate. | | Is_Affiliate | Indicates if the customer is marked as an affiliate. | | affiliate_email | If this customer has a separate email for their Paypal/affiliate commission, this will populate with that alternate email address. | | total_amnt_earned | If the customer is marked as an affiliate, this will populate with the total amount in commission they've earned with Yotpo Loyalty & Referrals. | After your customer attributes have been synced, you’ll be able to see them within your **Contacts** under **Data Fields**. ### Available Loyalty Events for Campaign Mapping **Campaign events** - Referral Link Share - Donation Created - Redemption Below Threshold - Points Changed - Referral Completed **Program events** - Loyalty Opt-in/out - Birthday Captured - Anniversary Captured - Points Reminder - Points Expiration Reminder - Redemption Reminder - Customer Birthday - Customer Anniversary - Tier Earned - Tier Lost - Points Earned - Referral Share Reminder ## Creating a Loyalty & Referrals Campaign in Dotdigital Once your customer attributes and events are synced, you can start building automated campaigns in Dotdigital. Below is a quick overview of how to include Yotpo loyalty attributes (“markers”) in your campaigns. To create or edit a triggered campaign: 1. In Dotdigital, go to the **Email** tab. 2. Under **Automation**, select **Triggered Email**. 3. Locate the campaign you want to edit and click the **Edit** icon. 4. You’ll be taken to the **Content** section of the campaign. To add loyalty personalization: 1. Click **Insert Action**. 2. Select **Personalize** to view available customer markers (including synced loyalty attributes). 3. Click into the email body where you’d like to insert the marker. 4. Select the relevant attribute (e.g., points balance, referral link, tier name). 5. Click **Save & Continue** when ready. You’ve now created a Dotdigital campaign powered by Yotpo Loyalty & Referrals events and attributes.