Skip to main content
All CollectionsThird-Party IntegrationKlaviyo
Klaviyo: ReferralCandy events and custom properties
Klaviyo: ReferralCandy events and custom properties

ReferralCandy events and custom properties you can use in your Klaviyo flows

Adam avatar
Written by Adam
Updated this week

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 short code, go to Campaigns. Select your campaign and click Campaign Settings.

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:

  1. Click Personalization for text blocks, or Add personalization in any other text field.

  2. Click the All types dropdown and select Custom. All ReferralCandy custom properties show up.

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


๐Ÿ’ฌ Need help? Click the chat widget on the right to start a conversation. Learn more


Did this answer your question?