← View All Guides
Mailjet logo
Integration Guide

How to Sync GrowSurf Referral Data to Mailjet Contacts

An API key and secret key, one contact list, and every contact carries their referral link as a property.

Want the full setup walkthrough?

Use these docs for exact setup steps, supported fields, and troubleshooting.

GrowSurf adds and updates contacts in the Mailjet list you choose and creates the contact properties holding each participant’s referral link, referral counts, referrer details, and milestone progress.

Mailjet issues API credentials in pairs. GrowSurf needs both halves — the API key and the secret key — so copy them together.

Integration Steps

Get both Mailjet keys

Copy your API key and secret key from Mailjet > Account > API Key Management. The secret is shown when the pair is created, so grab it at the same time as the key.

Connect Mailjet in GrowSurf

Open Program Editor > 4. Options > Integrations and search for Mailjet.

Searching for Mailjet in the GrowSurf Program Editor integrations list
Search the integrations list in Program Editor > 4. Options > Integrations.

Expand the card, enter both values, and submit.

The Mailjet API key and secret key fields in the GrowSurf Program Editor
Mailjet takes both halves of the credential pair.

Connect before importing participants; the sync covers people added from that point on. Already imported? Use the existing-participant sync options.

Choose the Mailjet list and save

Pick the contact list GrowSurf should keep current, then save changes. Contacts are added or updated there whenever someone joins your program or gets referred.

Know your contact properties

GrowSurf dataContact propertyTypeWhat it holds
Share URL[[data:grsf_share_url]]TextThe participant’s unique referral link
Participant ID[[data:grsf_participant_id]]TextThe participant’s GrowSurf ID
Referral Status[[data:grsf_referral_status]]TextCREDIT_PENDING, CREDIT_AWARDED, or CREDIT_EXPIRED
Participant first name[[data:grsf_participant_first_name]]TextThe participant’s first name
Participant last name[[data:grsf_participant_last_name]]TextThe participant’s last name
Referrer first name[[data:grsf_referrer_first_name]]TextThe referrer’s first name, when there is one
Referrer last name[[data:grsf_referrer_last_name]]TextThe referrer’s last name, when there is one
Referrer email[[data:grsf_referrer_email]]TextThe referrer’s email, when there is one
Total referral count[[data:grsf_total_referral_count]]NumberAll-time referral count
Monthly referral count[[data:grsf_monthly_referral_count]]NumberReferral count for the current month
Previous monthly referral count[[data:grsf_prev_monthly_referral_count]]NumberReferral count for the previous month
Next milestone[[data:grsf_next_milestone]]TextThe next milestone message, on programs with milestone rewards
Next monthly milestone[[data:grsf_next_monthly_milestone]]TextThe next monthly milestone message, when there is one
Total invite count[[data:grsf_total_invite_count]]NumberAll-time invite count
Total impression count[[data:grsf_total_impression_count]]NumberAll-time referral-link view count

Mailjet reads stored contact properties with the [[data:...]] form. Use them exactly as shown in campaign content.

Tips

Both halves, every time

An API key without its secret will not authenticate. If you have lost the secret, generate a new pair.

data: is for stored properties

Mailjet has several variable forms. GrowSurf writes contact properties, which are read with [[data:...]].

Connect before the first import

The sync does not reach back for contacts added earlier.

FAQ

Which Mailjet credentials do I need?

Both the API key and the secret key, from Mailjet’s API Key Management page.

What is the property syntax?

[[data:grsf_share_url]].

Does GrowSurf create the properties?

Yes, once connected and a list is selected.

Trusted by marketing and product teams that grow through customer, user, and partner referrals.