For the complete documentation index, see llms.txt. This page is also available as Markdown.

Klaviyo

Update Klaviyo contacts with their unique share link and referrer information.

Sync with your Klaviyo List

Step 1: In Program Editor > 4. Options > Integrations, open the Klaviyo integration card and enter your Klaviyo API secret (click here to get your Klaviyo private API key).

Connect Klaviyo before importing participants. If participants are already in your program, follow these ESP sync options to send their GrowSurf data to Klaviyo.

Step 2: Once connected, choose the Klaviyo list that you want to automatically sync to. GrowSurf will add/update your Klaviyo contacts every time a new participant is added or referred to your referral or affiliate program.

Step 3: Save changes. You should now see a screen that looks like the one below:

Examples

View our Klaviyo tutorials to see different kinds of examples that you can copy/paste into your email templates.

Custom Properties

GrowSurf will automatically create these new properties for your Klaviyo contacts.

Property Name

Custom Property Tag

Type

Description

Example

GrowSurf Share URL

{{ person|lookup:'GrowSurf Share URL' }}

TEXT

The participant's unique referral link

https://growsurf.com?grsf=absc123

GrowSurf Participant ID

{{ person|lookup:'GrowSurf Participant ID' }}

TEXT

The participant's unique GrowSurf ID

abc123

GrowSurf Referral Status

{{ person|lookup:'GrowSurf Referral Status' }}

TEXT

The referral status for the participant

CREDIT_ PENDING

GrowSurf Participant First Name

{{ person|lookup:'GrowSurf Participant First Name' }}

TEXT

The participant's first name

Bob

GrowSurf Participant Last Name

{{ person|lookup:'GrowSurf Participant Last Name' }}

TEXT

The participant's last name

Loblaw

GrowSurf Referrer First Name

{{ person|lookup:'GrowSurf Referrer First Name' }}

TEXT

The first name of the participant's referrer (if applicable)

Gavin

GrowSurf Referrer Last Name

{{ person|lookup:'GrowSurf Referrer Last Name' }}

TEXT

The last name of the participant's referrer (if applicable)

Belson

GrowSurf Referrer Email

{{ person|lookup:'GrowSurf Referrer Email' }}

TEXT

The email address of the participant's referrer (if applicable)

gavin.belson@hoolie.io

GrowSurf Total Referral Count

{{ person|lookup:'GrowSurf Total Referral Count' }}

NUMBER

The participant's all-time referral count

0

GrowSurf Lead Count

{{ person|lookup:'GrowSurf Lead Count' }}

NUMBER

The participant's current lead count (pending referrals that have not converted yet)

0

GrowSurf Monthly Referral Count

{{ person|lookup:'GrowSurf Monthly Referral Count' }}

NUMBER

The participant's current month referral count

19

GrowSurf Prev Monthly Referral Count

{{ person|lookup:'Prev Monthly Referral Count' }}

NUMBER

The participant's previous month referral count

20

GrowSurf Next Milestone

{{ person|lookup:'GrowSurf Next Milestone' }}

TEXT

The text for the next/upcoming milestone reward (only applies to milestone rewards. See an example here)

You are only 2 referrals away from winning a free t-shirt!

GrowSurf Next Monthly Milestone

{{ person|lookup:'GrowSurf Next Monthly Milestone' }}

TEXT

The text for the next/upcoming monthly milestone reward (only applies to milestone rewards. See an example here)

You are only 2 referrals away from winning a free t-shirt!

GrowSurf Total Invite Count

{{ person|lookup:'GrowSurf Total Invite Count' }}

NUMBER

The participant's all-time invite count

112

GrowSurf Total Impression Count

{{ person|lookup:'GrowSurf Total Impression Count' }}

NUMBER

The participant's all-time impression count

150

GrowSurf Language

{{ person|lookup:'GrowSurf Language' }}

TEXT

The participant's program language (ISO code such as es or pt-BR)

es

*GrowSurf Referral Status can have one of these values:

  • CREDIT_PENDING: The participant must trigger a referral before their referrer receives credit.

  • CREDIT_AWARDED: The participant triggered a referral, and their referrer received credit.

  • CREDIT_EXPIRED: The participant did not trigger a referral before the referral credit expired.

You can use these new properties in your Klaviyo email templates. For example, use {{ person|lookup:'GrowSurf Share URL' }} to add each participant's unique referral link.

​Click here to learn more about Klaviyo's template tags and variables.​

Troubleshooting Tips

  • Check the participant's activity logs if they do not sync. GrowSurf retries failed syncs for up to 7 days.

Last updated

Was this helpful?