Getting Started for Web
Start here once you've created your GrowSurf campaign.

Step 1: Install the GrowSurf Universal Code onto your site

Get the GrowSurf Universal Code.

The GrowSurf Universal Code is what allows referrals to be tracked and credited properly.
It's also what powers the GrowSurf window and embeddable elements to be displayed to your participants so that they can get their unique share link, click social share buttons, and check their referral stats and/or the leaderboard.
The GrowSurf Universal Code is a snippet of JavaScript that you paste into the <HEAD> of your website.
To get your campaign-specific GrowSurf Universal Code, follow the Installation steps in the Campaign Editor until you get to the instructions page (see image below). If your website is hosted on a popular platform such as Shopify or Squarespace, you can refer to our platform-specific instructions for granular instructions.
Find your campaign-specific GrowSurf Universal Code in the Installation step of the Campaign Editor
Note: Your campaign-specific GrowSurf Universal Code will work on any URL that shares the same origin (what's same-origin?) as the Share URL or Signup URL that you entered in the Installation step of the Campaign Editor. Click here for image​
Note: If you have Participant authentication/login enabled, you may want to set up Participant Auto Authentication.
(Optional) Share your dedicated landing page link
Every GrowSurf campaign comes with a dedicated landing page, which contains the GrowSurf window contents displayed as a webpage. You should only use this if you quickly want a dedicated landing page for your referral program (otherwise, we recommend that you create your own custom landing page for your referral campaign).
Just share your campaign-specific URL https://grow.surf/YOUR_CAMPAIGN_ID. Click here to see an example.
Also note that your participants can visit this URL to get their unique share link, share via social media buttons, and check their referral stats and/or the leaderboard.

Step 2: Integrate with GrowSurf API(s)

Use our client-side or server-side APIs to integrate with GrowSurf to add participants and to trigger referrals.
Development Tool
Type
Description
​JavaScript Web API​
Client-side
Create new participants, trigger referrals, get limited campaign data, get limited participant data, and open/close the GrowSurf window.
​REST API​
Server-side
Create new participants, trigger referrals, get campaign data, and get participant data from a secure environment.

Step 3: Automate reward fulfillment

Set up automatic reward fulfillment and data syncing by using Webhooks and/or Zapier.

Troubleshooting

To troubleshoot common issues during installation, check out Help Center - Installation articles.
Last modified 1mo ago