Implement your referral program

with minimal dev time

// Only creates a referred participant if the referral code is valid
const result = await growsurf.addReferredParticipant({
    email: '[email protected]',
    firstName: 'Gavin',
    lastName: 'Belson',

    // Optional: Save any custom data as participant metadata
    country: 'UK',
    subscriptionPlan: 'Pro',
});

if (result.added) {
    const participant = result.participant;
}

curl -X POST 'https://api.growsurf.com/v2/campaign/45hxmj/participant' \
     -H 'Authorization: Bearer YOUR_API_KEY' \
     -H 'Content-Type: application/json' \
     -d $'{
         "email": "[email protected]",
         "firstName": "Gavin",
         "lastName": "Belson",
         "referredBy": "richard-h8kp6l",

         # Optional: Save custom fields as participant metadata
         "metadata": {
             "country": "UK",
             "subscriptionPlan": "Pro"
         }
     }'

curl -X POST 'https://api.growsurf.com/v2/campaign/45hxmj/participant/[email protected]/ref' \
     -H 'Authorization: Bearer YOUR_API_KEY'

// Node.js webhook example

app.post('/your/webhook/payload-url', function(req, res) {
const body = req.body;

try {
    if (body.event === 'PARTICIPANT_REACHED_A_GOAL') {
        // Write code here to do something when a participant wins a reward
        console.log(`${body.data.participant.email} just won this reward: ${body.data.reward.description}`);

        // If the reward is approved
        if (body.data && body.data.reward && body.data.reward.approved) {
            // Do something

            // Optional: If there is any reward metadata, use it:
            if (body.data.reward.metadata && body.data.reward.metadata["proRewardValue"]) {
                console.log(`${body.data.participant.email} earned an amount of ${body.data.reward.metadata["proRewardValue"]}.`);
            }
        }

        // If this is a double-sided reward, use body.data.reward.isReferrer to determine if this is for the referrer or referred person
        if (body.data && body.data.reward && body.data.reward.isReferrer) {
            // Do something
        }
    }

} catch (err) {
res.status(400).end();
}
res.json({received: true});
});