SendGrid

Update/add SendGrid contacts with their unique share link and referrer information.

Note: The SendGrid integration is only available to users on a GrowSurf paid plan.

Sync with your SendGrid List

Step 2: Login to SendGrid and create a new SendGrid API key. Make sure the API key has Full Access to Marketing:

Step 2: In GrowSurf Campaign Editor > 4. Options > Integrations, open the SendGrid integration card and enter your SendGrid API key.

IMPORTANT: Because the GrowSurf data sync to SendGrid only occurs after you have connected with the integration, it is imperative to connect with the integration BEFORE importing participants. Click here to see remedy options if you have already imported participants into your campaign but would like to sync their GrowSurf data to SendGrid.

Step 3: Once connected, choose the SendGrid list that you want to automatically sync to. GrowSurf will add/update your SendGrid contacts every time a new participant is added or referred to your referral campaign.

Step 4: Save changes. You should now see a screen that looks like the one below:

Examples

View our SendGrid tutorials to see different kinds of examples that you can copy/paste into your email templates.

Custom Fields

GrowSurf will automatically create these new custom fields for your SendGrid contacts.

Custom fields	FIELD NAME	FIELD TYPE	Description	Example
GrowSurf Share URL	growsurf_share_url	text	The participant's unique referral link	https://growsurf.com?grsf=absc123
GrowSurf Participant ID	growsurf_participant_id	text	The participant's unique GrowSurf ID	abc123
GrowSurf Referral Status	growsurf_referral_status	text	The referral status of the participant*
GrowSurf Participant First Name	growsurf_participant_first_name	text	The participant's first name	Bob
GrowSurf Participant Last Name	growsurf_participant_last_name	text	The participant's last name	Loblaw
GrowSurf Referrer First Name	growsurf_referrer_first_name	text	The first name of the participant's referrer (if applicable)	Gavin
GrowSurf Referrer Last Name	growsurf_referrer_last_name	text	The last name of the participant's referrer (if applicable)	Belson
GrowSurf Referrer Email	growsurf_referrer_first_email	text	The email address of the participant's referrer (if applicable)	[e-mail]
GrowSurf Total Referral Count	growsurf_total_referral_count	number	The participant's all-time referral count	0
GrowSurf Monthly Referral Count	growsurf_monthly_referral_count	number	The participant's current month referral count	19
GrowSurf Prev Monthly Referral Count	growsurf_prev_monthly_referral_count	number	The participant's previous month referral count	20
GrowSurf Next Milestone	growsurf_next_milestone	text	The text for the next/upcoming milestone reward (only applies to milestone rewards. See an example here)	You are only 2 referrals away from winning a free t-shirt!
GrowSurf Next Monthly Milestone	growsurf_next_monthly_milestone	text	The text for the next/upcoming monthly milestone reward (only applies to milestone rewards. See an example here)	You are only 2 referrals away from winning a free t-shirt!
GrowSurf Total Invite Count	growsurf_total_invite_count	number	The participant's all-time invite count	112
GrowSurf Total Impression Count	growsurf_total_impression_count	number	The participant's all-time impression count	150

*GrowSurf Referral Status can be the following: CREDIT_PENDING (This participant must still trigger a referral for their referrer to receive referral credit), CREDIT_AWARDED (This participant triggered a referral and their referrer received referral credit), CREDIT_EXPIRED (This participant did not trigger the referral credit within the referral credit expiration window so their referrer did not receive referral credit).

You can use these new properties in your SendGrid email templates. Whether you launch a new marketing campaign or have an automated drip campaign going on, make sure to always includegrowsurf_share_url in your emails to provoke your contacts to make referrals!

​Click here to learn more about how to create custom fields in SendGrid.​

Troubleshooting Tips

• If the new participant isn't being added to SendGrid, or if they are being added but their unique referral link isn't being synced to SendGrid:

  • Activity logs will denote if a participant was added to SendGrid or if they failed to be added. (In the case of failure, GrowSurf will re-attempt to add them for 7 days).