← View All Guides
Kit logo
Integration Guide

How to Sync GrowSurf Referral Data to Kit Subscribers

One API secret, one Kit tag, and every subscriber carries their referral link as a custom field.

Want the full setup walkthrough?

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

Kit — the product formerly called ConvertKit — organizes people by tag, and GrowSurf syncs into the tag you pick. Each participant’s referral link, referral counts, referrer details, and milestone progress arrive as subscriber custom fields.

Because Kit runs on Liquid, those fields work in broadcasts, sequences, and conditional blocks with the same syntax.

Integration Steps

Get your Kit API secret

Copy your API secret from your Kit account settings. This is the secret, not the public API key.

Connect Kit in GrowSurf

Open Program Editor > 4. Options > Integrations and search for Kit.

Searching for Kit in the GrowSurf Program Editor integrations list
The integration is listed as Kit, its current brand name.

Expand the card, paste the API secret, and submit.

The Kit API secret field in the GrowSurf Program Editor
Paste the Kit API secret and submit.

Connect before you import participants; the sync starts from that moment. Already imported? Use the existing-participant sync options.

Choose the Kit tag

Pick the tag that should receive GrowSurf participants, then save. GrowSurf adds or updates a subscriber under that tag whenever someone joins or gets referred.

Know your subscriber fields

GrowSurf dataField shortcodeTypeWhat it holds
Share URL{{ subscriber.grsf_share_url }}TextThe participant’s unique referral link
Participant ID{{ subscriber.grsf_participant_id }}TextThe participant’s GrowSurf ID
Referral Status{{ subscriber.grsf_referral_status }}TextCREDIT_PENDING, CREDIT_AWARDED, or CREDIT_EXPIRED
Participant first name{{ subscriber.grsf_participant_first_name }}TextThe participant’s first name
Participant last name{{ subscriber.grsf_participant_last_name }}TextThe participant’s last name
Referrer first name{{ subscriber.grsf_referrer_first_name }}TextThe referrer’s first name, when there is one
Referrer last name{{ subscriber.grsf_referrer_last_name }}TextThe referrer’s last name, when there is one
Referrer email{{ subscriber.grsf_referrer_email }}TextThe referrer’s email, when there is one
Total referral count{{ subscriber.grsf_total_referral_count }}NumberAll-time referral count
Monthly referral count{{ subscriber.grsf_monthly_referral_count }}NumberReferral count for the current month
Previous monthly referral count{{ subscriber.grsf_prev_monthly_referral_count }}NumberReferral count for the previous month
Next milestone{{ subscriber.grsf_next_milestone }}TextThe next milestone message, on programs with milestone rewards
Next monthly milestone{{ subscriber.grsf_next_monthly_milestone }}TextThe next monthly milestone message, when there is one
Total invite count{{ subscriber.grsf_total_invite_count }}NumberAll-time invite count
Total impression count{{ subscriber.grsf_total_impression_count }}NumberAll-time referral-link view count

Kit reads these with Liquid through the subscriber object.

Tips

Secret, not the public key

Kit issues both. Only the API secret can manage subscribers and fields.

The tag is the trigger you already have

Kit automations can fire on tag added, so the GrowSurf tag doubles as an entry point for a welcome sequence about the referral program.

Connect before importing

The sync is forward-looking, so the order of operations matters more here than the settings do.

FAQ

Is this ConvertKit?

Yes. ConvertKit is now Kit, and the integration uses the current name.

Does GrowSurf sync to a tag or a form?

A tag. You select it after connecting.

What is the shortcode for the referral link?

{{ subscriber.grsf_share_url }}.

Trusted by marketing and product teams that grow through customer, user, and partner referrals.