Getting started

Step 1: Make sure the GrowSurf Universal Code is installed

When you have the GrowSurf Universal Code installed on a webpage, that webpage has access to the JavaScript Web API, and you are ready for development. You can test this by entering growsurf.open() in your browser's Developer Console.

grsfReady Event Listener

The GrowSurf Universal Code loads asynchronously, so if you intend on executing any growsurf functions on page load, you must wait until the library has completely loaded.

When loaded successfully, the GrowSurf Universal Code will dispatch a grsfReady event notifying any event listeners that it is ready for use. Only then will any GrowSurf JavaScript Web API functions work.

Example of using grsfReady

// Listen and wait for the Growsurf Universal Code to initialize
window.addEventListener('grsfReady', () => {
  console.log('GrowSurf is Ready!');
  // Your code goes here.... 
});

In some cases the GrowSurf Universal script may already be available and the grsfReady event may have already fired. This depends on how long it takes your scripts to load and can happen for various other reasons. If your grsfReadycallback isn't being invoked on thegrsfReady event we recommend you check to see if the growsurf script is already available before adding the event listener callback with a conditional like this...

// Check to see if GrowSurf is available
if(!growsurf) {
  // Listen and wait for the Growsurf Universal Code to initialize
  window.addEventListener('grsfReady', () => {
    console.log('GrowSurf is Ready!');
    // You code goes here.... 
  });
} else {
  console.log('GrowSurf is Already Available');
  // You code goes here....
}

If you are executing growsurf functions not on page load, we recommend you wrap them in a conditional like this...

Example of using a conditional

// Check if the GrowSurf Universal Code is present
if (growsurf) {
    // Then, open the GrowSurf window
    growsurf.open();
}

Next steps

View our Tutorials for implementing JavaScript Web API methods, or view documentation:

• ​Add participant​

• ​Trigger referral​

• ​Get campaign​

• ​Get participant by email​

• ​Get participant by ID​

• ​Get referrer ID​

• ​Get participant ID​

• ​Open GrowSurf window​

• ​Close GrowSurf window​

• ​Subscribe to event​