--- title: "Integrating Yotpo Loyalty & Referrals with Emarsys" slug: "integrating-yotpo-loyalty-referrals-with-emarsys" tags: ["Shopify Plus", "Shopify", "Salesforce Commerce Cloud", "Loyalty and Referrals", "Custom", "BigCommerce", "Adobe Commerce (Magento)"] updated: 2025-10-28T12:49:40Z published: 2025-10-28T12:49:40Z canonical: "support.yotpo.com/integrating-yotpo-loyalty-referrals-with-emarsys" --- > ## 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 Emarsys Products Loyalty ###### Supported plans Premium, Enterprise ###### eCommerce Platform Shopify, Shopify Plus, Adobe Commerce (Magento), BigCommerce, Salesforce Commerce Cloud, Custom ## Goals and Outcomes Emarsys enables personalized, one-to-one customer engagement across multiple marketing channels. By integrating Yotpo Loyalty & Referrals with Emarsys, you can automatically sync program-related data, such as loyalty attributes and referral events, to your Emarsys account. This integration allows you to: - Send loyalty and referral emails directly through Emarsys - Align customer messaging with loyalty status and activity - Manage all customer engagement flows in one platform ## Before You Begin To ensure proper communication between Yotpo and Emarsys, you need to update your API permissions in Emarsys: 1. In Emarsys, go to **Management > Security Settings > API Users**. 2. Click the **Edit** icon next to the relevant API user. 3. Enable the required API endpoints: **List of endpoints** - **Field** field.get field.create - **Event** externalevent.create externalevent.get externalevent.list externalevent.triggercontact.update - **Contact** contact.create contact.getdata contact.update contact.create contact.getdata - **Customer** customer.settings ## Enable the Integration in Emarsys To enable the integration, sign in to the Emarsys [Help Portal](https://help.emarsys.com/hc/en-us) and request to enable the Yotpo Referrals integration within your Emarsys account. Once the integration is enabled in your account: 1. **Log in** to Emarsys as the **Account Owner**. 2. Click **Admin > Security Settings**. 3. Create your **API Username** and **API Secret Key** choosing the WSSE authentication option (not OIDC). Make sure to copy and store these credentials securely as they cannot be retrieved later. **Note** Only the Emarsys **Account Owner** can create API credentials. ## Connect Emarsys to Yotpo Loyalty & Referrals Once you've enabled Yotpo Loyalty & Referrals in your Emarsys account and generated your API credentials, you'll need to connect Emarsys to your Yotpo Loyalty & Referrals account: 1. From your **Yotpo Loyalty admin**, go to [**Integrations Center**](https://loyalty-app.yotpo.com/integrations-center). 2. Search for the **Emarsys** tile and click to **connect** it. ![Yotpo Integrations Center - connect Emarsys](https://cdn.document360.io/f3c2ab59-fe4c-4f93-9614-2872f40e8aa7/Images/Documentation/yotpo-integrations-center-emarsys.png?sv=2026-02-06&spr=https&st=2026-11-05T20%3A42%3A04Z&se=2026-11-05T21%3A42%3A04Z&sr=c&sp=r&sig=98vR5aDYDsXnqBqnIWRdmxIAYDaF3S3NbKtJ7Ba6H9Q%3D) 3. Enter your **Emarsys API credentials** in the corresponding fields. ![Connect Emarsys to Yotpo Loyalty & Referrals](https://cdn.document360.io/f3c2ab59-fe4c-4f93-9614-2872f40e8aa7/Images/Documentation/emarsys-integration-connection-modal.png?sv=2026-02-06&spr=https&st=2026-11-05T20%3A42%3A04Z&se=2026-11-05T21%3A42%3A04Z&sr=c&sp=r&sig=98vR5aDYDsXnqBqnIWRdmxIAYDaF3S3NbKtJ7Ba6H9Q%3D) 4. Click **Connect**. Note Once connected, loyalty and referral events and attributes will begin syncing automatically. ### Loyalty & Referrals Events in Emarsys You can view externally mapped Yotpo Loyalty & Referrals events in your Emarsys admin under **External Events**. ****Loyalty and Referrals External Events**** - swell/points/earned - swell/redemption/created - swell/points/reminder - swell/redemption/reminder - swell/customer/birthday - swell/referral/share - swell/referral/completed - swell/tier/earned - swell/tier/lost - swell/purchase/payout/scheduled - swell/redemption/payout/scheduled - swell/purchase/payout/received - swell/purchase/payout/unclaimed - swell/redemption/payout/received - swell/referral/share/reminder - swell/referral_discount_code/updated - swell/birthday/captured - swell/redemption_code/below_threshold - swell/widgets/customer/authentication - loyalty/opt_in - loyalty/opt_out - loyalty/donation/created - loyalty/custom/reward/created - swell/points/changed - loyalty/anniversary/captured - swell/account/created - swell/newsletter/signup - loyalty/customer/anniversary - swell/referral_code/activated ### Creating Event-Based Automation Flows Event-based flows can be created through the Emarsys Automation Center: 1. Click **Campaigns > Automation Center**. 2. Create a new program from scratch by clicking **Create Blank Program**, or use an existing template by clicking **Create Program From Blueprint** and selecting the most relevant category. - You can also edit an existing program by clicking **Edit** next to the relevant program. 3. Add external events to your program using the **External Event** element in the **Entry Points** menu. 4. Click **External Event**, click the **External Event** box, and then select the desired Yotpo event from the **Node Settings** menu. ![](https://cdn.document360.io/f3c2ab59-fe4c-4f93-9614-2872f40e8aa7/Images/Documentation/e2ede04c-69de-4a64-a41b-38014fac8b72.png?sv=2026-02-06&spr=https&st=2026-11-05T20%3A42%3A04Z&se=2026-11-05T21%3A42%3A04Z&sr=c&sp=r&sig=98vR5aDYDsXnqBqnIWRdmxIAYDaF3S3NbKtJ7Ba6H9Q%3D) 5. Add any other conditions or triggers you'd like. 6. We recommend sending a [test email](https://esl.emarsys.com/hc/en-us/articles/10781102214929-Email-campaigns) to make sure your flow performs as intended. ## Adding Customer Attributes in Email Templates To include Yotpo Referrals customer attributes in Emarsys templates: 1. In Emarsys, go to Campaigns > Triggered Email. 2. Create a new mail stream or edit an existing one. 3. Choose Block-Based Email or Custom HTML Email. ![](https://cdn.document360.io/f3c2ab59-fe4c-4f93-9614-2872f40e8aa7/Images/Documentation/86968508-e367-4647-9bb5-1d7d45b391bc.png?sv=2026-02-06&spr=https&st=2026-11-05T20%3A42%3A04Z&se=2026-11-05T21%3A42%3A04Z&sr=c&sp=r&sig=98vR5aDYDsXnqBqnIWRdmxIAYDaF3S3NbKtJ7Ba6H9Q%3D) 4. In your template, insert [personalization variables](https://esl.emarsys.com/hc/en-us/articles/12280299474449-Personalisation-variables) where needed. 1. Add [event-related attributes](/v1/docs/email-integrations-attributes-events) in double brackets, e.g. **{{event.swell_perk_reward_points}}**, in line with Emarsys scripting language. 2. Add **customer attributes** as {{contact.*value of points balance param*}}. For example: **{{ contact.100009777 }}**, where100009777 directly corresponds with the Yotpo referrals points balance parameter defined in Emarsys. Note Attributes must follow [Emarsys Scripting Language (ESL)](https://esl.emarsys.com/hc/en-us/articles/9333248175249-What-is-ESL). Do not use **{{contact.swell_point_balance}}** formatting.