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:
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. |
|
RC FREN - Referral Link | The contact's referral link. |
|
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 qualify for the next reward.
For campaigns using multiple reward tiers, the property returns the number of referred purchases needed to qualify for the subsequent tier.
When the contact reaches the last tier, it depends on the tier setting you selected:
|
|
RC FREN - Next reward description | The description of the reward the contact will receive upon qualifying for their next referral reward.
The property returns the reward and description of the subsequent tier. If there are no subsequent tiers, the property doesn't return a value. | "a 10% discount" |
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
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
| When a contact meets the campaign's segment criteria and becomes enrolled in your referral or affiliate campaign. |
RC - Unenrolled
| When an advocate who was previously enrolled in your campaign doesn't meet the segment criteria anymore and becomes unenrolled. |
RC - Signup form submitted
| When a contact, who is never enrolled in the campaign, signs up via a form.
Form types:
|
RC - Waitlisted
| 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
| When a referred purchase is made through the advocate's referral link. |
RC - Purchase referred by profile made ineligible
| When a referred purchase is flagged as ineligible. |
RC - Reward earned
| When an advocate successfully earns a reward from a referral. |
RC - Subscribed to campaign emails
| When a contact is subscribed to the campaign emails, allowing you to send out campaign emails to them. |
RC - Unsubscribed from campaign emails
| 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