SendGrid

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

Sync with your SendGrid List

Step 1: Log in to SendGrid and create a new SendGrid API key. Make sure the API key has Full Access to Marketing:

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

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

Getting an error while connecting your API key? As of August 8, 2025, SendGrid requires separate purchases for their Marketing Campaigns and Email API products. Please make sure that you have paid access to their Marketing Campaigns product. Note that if you have purchased both products, you can use the same account (and API key) to send via the Email API or through Marketing Campaigns.

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 or affiliate program.

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 Lead Count	growsurf_lead_count	number	The participant's current lead count (pending referrals that have not converted yet)	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 Language	growsurf_language	text	The participant's program language (ISO code such as es or pt-BR)	es

*GrowSurf Referral Status can have one of these values:

• CREDIT_PENDING: The participant must trigger a referral before their referrer receives credit.

• CREDIT_AWARDED: The participant triggered a referral, and their referrer received credit.

• CREDIT_EXPIRED: The participant did not trigger a referral before the referral credit expired.

You can use these new properties in your SendGrid email templates. For example, use growsurf_share_url to add each participant's unique referral link.

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

Troubleshooting Tips

• Check the participant's activity logs if they do not sync. GrowSurf retries failed syncs for up to 7 days.