← View All Guides
Amplitude logo
Integration Guide

How to Track GrowSurf Referral Events in Amplitude

Connect GrowSurf to Amplitude so you can verify referral events, inspect participant properties, and build reporting around referral activity.

Want the full setup walkthrough?

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

GrowSurf has a native Amplitude integration that sends referral events into your Amplitude project and identifies participants by email.

Once the integration is live, validate the incoming growsurf_* events in Amplitude before you build dashboards, cohorts, or funnel views on top of them.

Integration Steps

Connect Amplitude in GrowSurf

GrowSurf campaign editor with the Amplitude integration card open
GrowSurf connects to Amplitude from the Amplitude card in Campaign Editor > 4. Options > Integrations.

Open the Amplitude integration card in your GrowSurf campaign, enter your Amplitude API key, and click Connect. If you already load Amplitude on the same pages, the API key is optional, but GrowSurf still recommends adding it so referral events are covered everywhere they need to fire.

Keep the GrowSurf event set enabled

GrowSurf enables the Amplitude event set by default after you connect. The core referral event family is growsurf_signup, growsurf_share, growsurf_invite, growsurf_referral, and growsurf_referral_trigger.

  • Use growsurf_signup to confirm new referrers are joining the program.
  • Use growsurf_share and growsurf_invite to measure sharing activity.
  • Use growsurf_referral and growsurf_referral_trigger to separate referred signups from qualified referrals.

Confirm the stream in Amplitude Live Events

Amplitude Live Events showing GrowSurf events such as growsurf_signup and growsurf_share
Amplitude Live Events is the fastest place to confirm that GrowSurf is sending the referral event stream you expect.

Before you trust any dashboard, open Live Events in Amplitude and make sure the GrowSurf events are arriving. GrowSurf's docs note that you should whitelist the referral portal and the referred-friend landing page in Amplitude so the full referral flow is tracked.

Open one participant profile and inspect the event properties

Amplitude user profile showing GrowSurf event properties such as participant email and share URL
A single user profile helps you verify the event properties attached to GrowSurf referral activity before you build reports from them.

Click into one user in Amplitude and verify the event properties attached to the GrowSurf events. The user profile view is where you can spot mismatched participant emails, missing share URLs, or missing referral activity before those issues turn into reporting errors.

Build reporting from the verified event family

After the event stream looks correct, use the GrowSurf events in Amplitude charts, cohorts, or funnel reports. That gives your team one analytics layer for referrer joins, shares, invite sends, referred signups, and qualified referral triggers.

Tips

Allow for Amplitude processing time

GrowSurf's docs call out that Amplitude can take up to 15 minutes to process incoming events, so check Live Events first before assuming the integration is broken.

Disconnect the integration if you want the stream to stop

If you no longer want GrowSurf sending Amplitude data, disconnect the integration entirely. Turning off a few event checkboxes is not the same as disconnecting the integration.

FAQ

Do I need an Amplitude API key if Amplitude is already installed on my site?

No. GrowSurf's docs say the API key is optional when you are certain Amplitude already loads on the relevant pages, but GrowSurf still recommends entering it to avoid missing referral surfaces.

Why are GrowSurf events missing from Amplitude right after setup?

Check for ad blockers, confirm the referral portal and referred-friend landing page are whitelisted, and allow up to 15 minutes for Amplitude to process the events.

How does GrowSurf identify users in Amplitude?

GrowSurf identifies participants by email address and avoids double-loading the Amplitude library if Amplitude is already installed.

Set up your refer a friend program with customer referral and affiliate program software that lowers your acquisition costs, increases customer loyalty, and saves you gobs of time.

Trusted by marketing and product teams at fast-growing B2C, fintech, and SaaS companies