Integration Guide

How to Add Referral Links to Kit Broadcasts and Sequences

Kit runs on Liquid, so GrowSurf referral fields drive both the copy and the conditions in one email.

Want the full setup walkthrough?

Use these docs for exact setup steps, supported fields, and troubleshooting.

GrowSurf Kit email tutorials Kit basic Liquid personalization

With GrowSurf syncing into Kit, each subscriber carries their referral link and progress as custom fields. Kit reads them with Liquid, which means you can print a value and branch on it in the same broadcast.

That matters for referral email: the person who has never shared and the person on their fourth referral need different sentences, and Liquid lets one send cover both.

Integration Steps

Confirm the fields are syncing

The Kit API secret field in the GrowSurf Program Editor — Kit lives in Program Editor > 4. Options > Integrations.

Open a subscriber in Kit that has already synced and check the GrowSurf fields carry values.

Print the link, visibly

Use {{ subscriber.grsf_share_url }} as the href and the visible text. Kit audiences forward emails a lot, and a visible URL survives the forward.

Branch on referral count

A Liquid if on {{ subscriber.grsf_total_referral_count }} lets you congratulate active referrers and invite everyone else, without building two broadcasts.

Reuse it in a sequence

The same Liquid works in sequence emails. A broadcast reaches the list once; a sequence email reaches every new subscriber at the same point in their onboarding, without you sending again.

If different referral outcomes should be worth different amounts, set that up with dynamic rewards in GrowSurf rather than in the email.

Code Snippets

The referral link

<p>Share your referral link:</p>
<a href="{{ subscriber.grsf_share_url }}">{{ subscriber.grsf_share_url }}</a>

One broadcast, two messages

{% if subscriber.grsf_total_referral_count > 0 %}
  <p>You have {{ subscriber.grsf_total_referral_count }} referrals. {{ subscriber.grsf_next_milestone }}</p>
{% else %}
  <p>Share your link and earn your first reward.</p>
{% endif %}

A link into your referral portal

<a href="https://grow.surf/YOUR_PROGRAM_ID?grsf_email={{ subscriber.email_address }}">
  View your referral progress
</a>

Replace YOUR_PROGRAM_ID with your GrowSurf Program ID, or use your custom Referral Portal domain.

Tips

Liquid fails quietly

A misspelled field name renders empty rather than erroring. Send yourself a test as a real, synced subscriber before the broadcast goes out.

Branch on the count, not the milestone

{{ subscriber.grsf_next_milestone }} is blank on programs without milestone rewards, so it makes an unreliable condition. The referral count is always present.

Put the ask where new subscribers will meet it

A broadcast only reaches people who are already on the list. A sequence keeps asking everyone who joins later, with no further work from you.

FAQ

What Liquid object holds the GrowSurf fields?

subscriber, for example {{ subscriber.grsf_share_url }}.

Can I use conditions on referral data?

Yes. Kit’s Liquid supports if blocks on any custom field, including the referral counts.

Do these work in sequences as well as broadcasts?

Yes, identically.

How to Add Referral Links to Kit Broadcasts and Sequences

Integration Steps

Confirm the fields are syncing

Print the link, visibly

Branch on referral count

Reuse it in a sequence

Code Snippets

Tips

Liquid fails quietly

Branch on the count, not the milestone

Put the ask where new subscribers will meet it

How to Sync GrowSurf Referral Data to Kit Subscribers

How to Add Referral Links to Drip Broadcasts and Workflows

How to Personalize Klaviyo Referral Emails with GrowSurf

FAQ

What Liquid object holds the GrowSurf fields?

Can I use conditions on referral data?

Do these work in sequences as well as broadcasts?

Turn word of mouth into steady growthfrom your customers

Built for lean teams,scaled for category leaders

View GrowSurfCustomer Examples

Turn word of mouth into steady growth
from your customers

Built for lean teams,
scaled for category leaders

View GrowSurf
Customer Examples