You can update the campaign referral trigger in the Installation step of the Campaign Editor (see image). Depending on what you select, the API will automatically set a default value for the participant:
If the referral trigger is Sign up + Qualifying Action, then referralStatus will default to CREDIT_PENDING
If the referral trigger is Sign Up, then referralStatus will default to CREDIT_AWARDED
post
https://api.growsurf.com/v2
/campaign/:id/participant/:participantId/ref
Trigger Referral by Participant ID
Important Notes:
Referral credit will only be awarded to the referrer if the participant referralStatus has a value of CREDIT_PENDING
Make sure your campaign's referral trigger is set to Sign Up + Qualifying Action (see image). If the referral trigger is set to Sign Up Event, triggering referrals will not work since referral credit has already been provided.
post
https://api.growsurf.com/v2
/campaign/:id/participant/:participantEmail/ref
Trigger Referral by Participant Email
Important Notes:
Referral credit will only be awarded to the referrer if the participant referralStatus has a value of CREDIT_PENDING
Make sure your campaign's referral trigger is set to Sign Up + Qualifying Action (see image). If the referral trigger is set to Sign Up, triggering referrals will not work since referral credit has already been provided.
post
https://api.growsurf.com/v2
/campaign/:id/participant/:participantId
Update Participant by ID
*Please see our API Guidelines for more information about metadata.
post
https://api.growsurf.com/v2
/campaign/:id/participant/:participantEmail
Update Participant by Email
*Please see our API Guidelines for more information about metadata.