The Klaviyo integration lets you push information about your referral or affiliate campaigns and contacts from ReferralCandy to your Klaviyo account. Use the ReferralCandy custom properties and events to build your flows in Klaviyo.

Custom properties

Below is a list of ReferralCandy custom properties you can use in Klaviyo.

Note: The default campaign short code FREN is used here as an example. Use the short code you've set for your campaign when using custom properties.

Where to find your short code

To find your campaign's short code:

From the ReferralCandy dashboard, go to Campaigns > Select your campaign > Campaign Settings.
From your Shopify admin, go to Campaigns > Select your campaign. In the Get started section, click Campaign details.

Profile custom properties

The custom properties below show profile information about your contacts.

Custom Property	Description	Sample Value
RC FREN - Name	The contact's name provided upon self-signup.	Alice
RC FREN - Portal link	The contact's sharing page.	`https://yourstore.referralcandy.com/DXTMKK4`
RC FREN - Referral Link	The contact's referral link.	`https://yourstore.refr.cc/campaign/u/alice`
RC FREN - Referred purchase accumulated	Total number of approved rewardable referred purchases accumulated by the contact.	1
RC FREN - Referred purchase needed for next reward	Total number of approved referred purchases needed for the contact to be qualified for the next reward.	1

ReferralCandy doesn't support a Klaviyo custom property for the referral code or the friend offer code, only the referral link. When clicked, the referral link redirects users to the friend offer landing page, which contains the friend offer code.

Timestamp custom properties

The custom properties below show timestamp information based on actions done to a profile. These custom properties are intended for debugging or admin purposes. The value is in the Unix format (ex: "1660724560").

RC FREN - Banned at
RC FREN - Deleted at
RC FREN - Enrolled at
RC FREN - Unenrolled at
RC FREN - Unsubscribed at
RC FREN - Updated at

Inserting a custom property

To add the ReferralCandy custom properties outlined above to your content:

Click Personalization for text blocks, or Add personalization in any other text field.
Click the All types dropdown and select Custom. All ReferralCandy custom properties show up.
Select a custom property to insert into the content of your email, SMS, or push message.

If you're running multiple campaigns, take note of your campaign short codes to identify which campaign a property belongs to.

Read this guide from the Klaviyo help center to learn more.

Events and triggers

These are the events that you can use to trigger targeted email flows. You can use these events together with custom properties to create a variety of targeted emails for different purposes.

When any of the events are triggered, all ReferralCandy custom properties are updated for the customer profile.

Events and event variables	Trigger
RC - Enrolled Campaign name First time enrollment (True or False)	When a contact meets the campaign's segment criteria and becomes enrolled in your referral or affiliate campaign.
RC - Unenrolled Campaign name	When an Advocate, who was previously enrolled in your campaign, doesn't meet the segment criteria anymore and becomes unenrolled.
RC - Signup form submitted Campaign name Form type	When a contact, who is never enrolled in the campaign, signs up via a form. Form types: Post-purchase popup (if signups are enabled) Referral extension (if signups are enabled) Referral widget Join page Embedded signup form
RC - Waitlisted Campaign name Form type	When a contact, who was never enrolled in the campaign, doesn't meet the segment criteria of your campaign after signup. Learn more
RC - Purchase referred by profile detected Campaign name Currency Purchase amount	When a referred purchase is made through the Advocate's referral link.
RC - Purchase referred by profile made ineligible Campaign name Reason	When a referred purchase is flagged as ineligible.
RC - Reward earned Campaign name Date earned Reward type Reward amount Reward currency (Coupon) Coupon code (Coupon) Coupon expiry date (Cash) Reward percentage (Cash) Portal login link	When an Advocate successfully earns a reward from a referral.
RC - Subscribed to campaign emails Campaign name	When a contact is subscribed to the campaign emails, allowing you to send out campaign emails to them.
RC - Unsubscribed from campaign emails Campaign name	When a contact has unsubscribed from receiving campaign emails.
RC - Banned from ReferralCandy	When you ban a contact in your ReferralCandy account.
RC - Removed from ReferralCandy	When you delete a contact from your ReferralCandy account.

Note: If you integrated Klaviyo with ReferralCandy before March 5, 2024, you'll still receive the following legacy events:

RC - Enrolled via post purchase - Triggered when a purchase is made.
RC - Enrolled via signup form - Triggered when a new signup is detected.
RC - Enrolled via invitation - Triggered when a new customer is enrolled via the Import Contacts page.

Up next

Klaviyo: Setting up your email flows

💬 Need help? Click the chat widget on the right to start a conversation. Learn more

Klaviyo: Setting up your email flows

Klaviyo flows: Sending a referral email upon enrollment

Klaviyo flows: Sending reward notifications

Klaviyo Flows: Additional notifications

Klaviyo: Import past customers to ReferralCandy