---
title: "Email Integrations - Attributes & Events"
slug: "email-integrations-attributes-events"
tags: ["Shopify", "Salesforce Commerce Cloud", "Shopify Plus", "Adobe Commerce (Magento)", "Custom", "BigCommerce", "Loyalty and Referrals"]
updated: 2024-07-21T05:38:21Z
published: 2024-07-21T05:38:21Z
canonical: "support.yotpo.com/email-integrations-attributes-events"
---

> ## 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.

# Yotpo Loyalty & Referrals Attributes and Events for Email Integrations

Products

  

Loyalty & Referrals

###### Supported plans

Pro, Premium, Enterprise

###### eCommerce Platform

Shopify, Shopify Plus, BigCommerce, Salesforce Commerce Cloud, Adobe Commerce (Magento), Custom

## Customer attributes

| Name | Long Name | Short Name | Data Type |
| --- | --- | --- | --- |
| VIP Tier Ends At | swell_vip_tier_ends_at | SWELL_VPTE | date |
| Referral Discount Code | swell_referral_discount_code | SWELL_REFD | text |
| Has Account | swell_has_account | SWELL_HASA | number |
| Name | swell_name | SWELL_NAME | text |
| First Name | swell_first_name | SWELL_FINA | text |
| Last Name | swell_last_name | SWELL_LANA | text |
| Point Balance | swell_point_balance | SWELL_PBAL | number |
| Points Earned | swell_points_earned | SWELL_PEAR | number |
| Referral Link | swell_referral_link | SWELL_REFL | text |
| Credit Balance | swell_credit_balance | SWELL_CBAL | text |
| VIP Tier Points Earned | swell_tier_points_earned | SWELL_TPE | number |
| VIP Tier Points Needed | swell_tier_points_needed | SWELL_TPN | number |
| VIP Tier Amount Spent Cents | swell_tier_amount_spent_cents | SWELL_TAMSC | number |
| VIP Tier Amount Spend Needed | swell_tier_amount_spend_needed_cents | SWELL_TASNC | number |
| VIP Tier Amount Sent | swell_tier_amount_spent | SWELL_TAMS | text |
| VIP Tier Amount Spend Needed | swell_tier_amount_spend_needed | SWELL_TASN | text |
| VIP Tier Purchases Made | swell_tier_purchases_made | SWELL_TPM | number |
| VIP Tier Purchases Needed | swell_tier_purchases_needed | SWELL_TPUN | number |
| VIP Tier Referrals Completed | swell_tier_referrals_completed | SWELL_TRC | number |
| VIP Tier Referrals Needed | swell_tier_referrals_needed | SWELL_TRN | number |
| Birth Month | swell_birth_month | SWELL_BIRM | text |
| Birth Day | swell_birth_day | SWELL_BIRD | text |
| Birth Year | swell_birth_year | SWELL_BIRY | text |
| VIP Tier Name | swell_vip_tier_name | SWELL_VPTN | text |
| VIP Tier Multiplier | swell_tier_multiplier | SWELL_TMUL | text |
| VIP Tier Reward Points | swell_tier_reward_points | SWELL_TRP | text |
| VIP Tier Redemption Option Name | swell_tier_redemption_option_name | SWELL_TRON | text |
| VIP Next Tier Name | swell_next_tier_name | SWELL_NTN | text |
| VIP Next Tier Multiplier | swell_next_tier_multiplier | SWELL_NTM | text |
| VIP Next Tier Reward Points | swell_next_tier_reward_points | SWELL_NTRP | text |
| VIP Next Tier Redemotion Option | swell_next_tier_redemption_option_name | SWELL_NTRON | number |
| Is Affiliate | swell_is_affiliate | SWELL_ISAF | number |
| Affiliate Email | swell_affiliate_email | SWELL_AFEM | text |
| Payout Percentage | swell_payout_percentage | SWELL_PPER | text |
| Has Provided Tax Details | swell_has_provided_tax_details | SWELL_HPTD | number |
| Total Amount Earned | swell_total_amount_earned | SWELL_TAE | text |
| Points Expire At | swell_points_expire_at | SWELL_PEA | date |
| Opted In Status | loyalty_opt_in | LOYAL_OTIN | number |
| Opted In At | loyalty_opt_in_at | LOYAL_OIAT | number |

## Event attributes

| Name | Long Name | Short Name | Data Type |
| --- | --- | --- | --- |
| Latest Points Earned | swell_perk_reward_points |  | number |
| Latest History Title | swell_perk_history_title |  | text |
| Latest Coupon Code | swell_coupon_code |  | text |
| Latest Referred Customer Email | swell_referred_email |  | text |
| Latest Referred Customer Name | swell_referred_name |  | text |
| Points Needed | swell_points_needed |  | number |
| Reward Name | swell_redemption_name |  | text |
| Latest Points Redeemed | swell_redemption_amount |  | number |
| Payout Amount | swell_payout_amount | SWELL_PYAM | text |
| Payout Claim By Date | swell_payout_claim_by_date | SWELL_PCBD | text |
| Payout Date | swell_payout_date | SWELL_PYDA | text |
| Referred Customer Email | swell_referred_customer_email | SWELL_RCUE | text |
| Referred Customer Amount Spent | swell_referred_customer_amount_spent | SWELL_RCAS | text |
| Referred Customer Purchased On | swell_referred_customer_purchased_on | SWELL_RCPO | text |
| Redemption Option Name | swell_redemption_option_name | SWELL_ROPN | text |
| Referrer Name | swell_referrer_name |  | text |
| Referrer Email | swell_referrer_email |  | text |
| Widget url | widget_url | SWELL_WIDGET_URL | text |
| Widget type | widget_type | SWELL_WIDGET_TYPE | text |
| Website url | website_url | SWELL_WEBSITE_URL | text |

## Yotpo Loyalty & Referrals events

| Name | Topic | Included Attributes | Possible Attributes |
| --- | --- | --- | --- |
| Points Earned | swell/points/earned | swell_perk_reward_pointsswell_perk_history_title |  |
| Redemption Created | swell/redemption/created | swell_coupon_code | swell_redemption_nameswell_redemption_amountswell_redemption_option_nameswell_perk_reward_pointsswell_perk_reward_points |
| Points Reminder | swell/points/reminder | swell_redemption_nameswell_redemption_amountswell_points_needed |  |
| Redemption Reminder | swell/redemption/reminder | swell_redemption_nameswell_redemption_amount |  |
| Customer Birthday | swell/customer/birthday | swell_perk_reward_pointsswell_perk_history_title | swell_coupon_codeswell_redemption_nameswell_redemption_amount |
| Referral Share | swell/referral/share | swell_referrer_nameswell_referrer_email |  |
| Referral Completed | swell/referral/completed | swell_perk_reward_pointsswell_perk_history_title | swell_referred_emailswell_referred_nameswell_coupon_codeswell_redemption_nameswell_redemption_amount |
| Tier Earned | swell/tier/earned |  | swell_coupon_codeswell_redemption_nameswell_redemption_amount |
| Tier Lost | swell/tier/lost |  |  |
| Purchase Payout Scheduled | swell/purchase/payout/scheduled | swell_payout_amountswell_payout_date | swell_referred_customer_emailswell_referred_customer_amount_spentswell_referred_customer_purchased_onswell_redemption_option_name |
| Redemption Payout Scheduled | swell/redemption/payout/scheduled | swell_payout_amountswell_payout_date | swell_referred_customer_email swell_referred_customer_amount_spentswell_referred_customer_purchased_onswell_redemption_option_name |
| Purchase Payout Recevied | swell/purchase/payout/received | swell_payout_amountswell_payout_dateswell_payout_claim_by_date | swell_referred_customer_emailswell_referred_customer_amount_spentswell_referred_customer_purchased_onswell_redemption_option_nameswell_redemption_nameswell_redemption_amount |
| Purchase Payout Unclaimer | swell/purchase/payout/unclaimed | swell_payout_amountswell_payout_dateswell_payout_claim_by_date | swell_referred_customer_emailswell_referred_customer_amount_spentswell_referred_customer_purchased_onswell_redemption_option_nameswell_redemption_nameswell_redemption_amount |
| Redemption Payout Recevied | swell/redemption/payout/received | swell_payout_amountswell_payout_dateswell_payout_claim_by_date | swell_referred_customer_emailswell_referred_customer_amount_spentswell_referred_customer_purchased_onswell_redemption_option_nameswell_redemption_nameswell_redemption_amount |
| Redemption Payout Unclaimed | swell/redemption/payout/unclaimed | swell_payout_amountswell_payout_dateswell_payout_claim_by_date | swell_referred_customer_emailswell_referred_customer_amount_spentswell_referred_customer_purchased_onswell_redemption_option_namesswell_redemption_nameswell_redemption_amount |
| Referral Share Reminder | swell/referral/share/reminder | swell_referrer_nameswell_referrer_email |  |
| Referral Discount Code Updated | swell/referral_discount_code/updated |  |  |
| Birthday Captured | swell/birthday/captured |  |  |