Loops

Sync GrowSurf participants and referral data to a Loops mailing list.

Sync participants to a Loops mailing list

Step 1: In Loops > Settings > API, generate a new API key, and copy it.

Step 2: In GrowSurf, open Program Editor > 4. Options > Integrations > Loops. Enter the API key, then connect your account.

Connect Loops with an API key.

Step 3: Select the Loops mailing list that should receive GrowSurf participants, then save your changes. GrowSurf creates the Contact Properties listed below and starts syncing new and updated participants.

Select the Loops mailing list that should receive participant data.

Connect Loops before importing participants. If participants are already in your Program, follow these ESP sync options to send their GrowSurf data to Loops.

Contact Properties

GrowSurf creates these account-level Contact Properties in Loops. Use the property API name inside braces, such as {grsfShareUrl}.

Contact Property	API name	Type	Description	Example
GrowSurf Share URL	grsfShareUrl	String	The participant's unique referral link	https://growsurf.com?grsf=abc123
GrowSurf Participant ID	grsfParticipantId	String	The participant's GrowSurf ID	abc123
GrowSurf Referral Status	grsfReferralStatus	String	The participant's referral-credit status	CREDIT_PENDING
GrowSurf Participant First Name	grsfParticipantFirstName	String	The participant's first name	Bob
GrowSurf Participant Last Name	grsfParticipantLastName	String	The participant's last name	Loblaw
GrowSurf Referrer First Name	grsfReferrerFirstName	String	The referrer's first name, when applicable	Gavin
GrowSurf Referrer Last Name	grsfReferrerLastName	String	The referrer's last name, when applicable	Belson
GrowSurf Referrer Email	grsfReferrerEmail	String	The referrer's email, when applicable	[e-mail]
GrowSurf Total Referral Count	grsfTotalReferralCount	Number	The participant's all-time referral count	12
GrowSurf Monthly Referral Count	grsfMonthlyReferralCount	Number	The participant's referral count for the current month	3
GrowSurf Previous Monthly Referral Count	grsfPrevMonthlyReferralCount	Number	The participant's referral count for the previous month	8
GrowSurf Next Milestone	grsfNextMilestone	String	The next milestone message, when the Program uses milestone rewards	2 referrals until your next reward
GrowSurf Next Monthly Milestone	grsfNextMonthlyMilestone	String	The next monthly milestone message, when applicable	1 referral until this month's reward
GrowSurf Total Invite Count	grsfTotalInviteCount	Number	The participant's all-time invite count	24
GrowSurf Total Impression Count	grsfTotalImpressionCount	Number	The participant's all-time referral-link view count	150

The referral status can be CREDIT_PENDING, CREDIT_AWARDED, or CREDIT_EXPIRED.

View the Loops tutorials for copy-and-paste examples. View Loops' Contact Properties guide to see how to add these values to campaign and workflow emails.

Troubleshooting

• If GrowSurf cannot connect, generate a new key under Loops > Settings > API and try again.

• If the selected mailing list was deleted, choose an existing list in GrowSurf and save again.

• Loops does not allow an unsubscribed Contact to be added back to a mailing list. That Contact can fail while the rest of the integration continues syncing normally.

• Check the GrowSurf participant's activity logs when a participant does not sync. GrowSurf retries temporary provider errors for up to seven days.