GrowSurf Docs
Help CenterSystem StatusContact SupportYour Dashboard →
  • Welcome
  • Getting Started for Web
    • Google Tag Manager
    • Participant Auto Authentication
  • Getting Started for Native Mobile
  • Developer Tools
    • Embeddable Elements
    • JavaScript SDK
      • Tutorials
      • Single Page Applications
      • API Reference
    • REST API
      • Tutorials
      • Objects
      • API Reference
      • API Guidelines
      • API Response Codes
    • Webhooks
      • Securing Your Webhooks (optional)
      • Examples
      • Events Reference
    • Metadata
  • Integrations
    • ActiveCampaign
      • Tutorials
    • Amplitude
    • AWeber
      • Tutorials
    • Brevo (formerly Sendinblue)
      • Tutorials
    • Cal.com
    • Calendly
    • Campaign Monitor
      • Tutorials
    • Chargebee
    • Constant Contact
      • Tutorials
    • ConvertKit
      • Tutorials
    • Customer.io
      • Tutorials
    • Drip
      • Tutorials
    • EmailOctopus
      • Tutorials
    • Fullstory
    • GetResponse
      • Tutorials
    • Google Ads
    • Google Analytics
    • Heap
    • Help Scout
    • HubSpot
      • Tutorials
    • Intercom
      • Tutorials
    • Klaviyo
      • Tutorials
    • LinkedIn Ads
    • Mailchimp
      • Tutorials
    • MailerLite
      • Tutorials
    • Mailjet
      • Tutorials
    • Make
      • Tutorials
    • Marketo
      • Tutorials
    • Meta (Facebook) Ads
    • Mixpanel
    • Pabbly Connect
      • Tutorials
    • PayPal
    • Pendo
    • PostHog
    • Recurly
    • Salesforce
      • Tutorials
    • Segment
    • SendGrid
      • Tutorials
    • Slack
    • Stripe
    • Tango Card
    • Typeform
    • X (Twitter) Ads
    • Zapier
      • Tutorials
      • Using Filters
      • Troubleshooting
Powered by GitBook
On this page
  • Step 1: Install the GrowSurf Universal Code onto your site
  • Step 2: Integrate with GrowSurf API(s)
  • Step 3: Automate reward fulfillment
  • Troubleshooting

Was this helpful?

Getting Started for Web

For web integration, start here once you've created your GrowSurf campaign.

Last updated 5 months ago

Was this helpful?

Sandbox/testing environment

To start building your referral program in a "sandbox" environment, we recommend creating two GrowSurf separate campaigns (one for development and one for production).

A campaign is simply a referral program. Every GrowSurf campaign has a unique ID that you can find in the URL or from the campaign's GrowSurf Universal Code. .

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).

Note:

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

Client-side

Create new participants, trigger referrals, get limited campaign data, get limited participant data, and open/close the GrowSurf window.

Server-side

Create new participants, trigger referrals, get campaign data, and get participant data from a secure environment.

Step 3: Automate reward fulfillment

Troubleshooting

Your campaign-specific GrowSurf Universal Code will work on any URL that shares the same origin () as the Share URL or Signup URL that you entered in the Installation step of the Campaign Editor.

If you have Participant authentication/login enabled, you may want to set up .

To set up a development process that supports multiple environments (e.g, development, production), .

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

To troubleshoot common issues during installation, check out articles.

what's same-origin?
Click here for image
Participant Auto Authentication
view this article
Webhooks
Zapier
Help Center - Installation
JavaScript Web API
REST API
Learn more here
Find your campaign-specific GrowSurf Universal Code in the Installation step of the Campaign Editor