GoHighLevel

The ReferralHero / GoHighLevel integration is a robust solution offering several powerful functionalities:

• Import existing contacts from GoHighLevel to ReferralHero

• Automatically add new GoHighLevel contacts to ReferralHero

• Sync ReferralHero subscribers to your GoHighLevel account

• Use your own GoHighLevel form to add new contacts to your ReferralHero campaign

• Trigger a ReferralHero conversion event when an Opportunity Status or Stage changes in GoHighLevel

Import GoHighLevel Contacts into ReferralHero

If you have existing contacts in GoHighLevel and want to import them into your ReferralHero campaign, follow these steps:

1. Go to your Campaign Dashboard → Edit Campaign → Add Subscribers → Import via Integration.

2. If your GoHighLevel account is not connected yet, go to the Integrations section and complete the connection.

3. Once connected, the Import from GoHighLevel block will appear. Click Import to import your contacts.

4. Imported subscribers will automatically receive the Welcome Email/SMS if it is enabled in your campaign.

NOTE: The import starts immediately. Depending on the number of subscribers, it may take from a few minutes to several hours. You will receive an email when the import is complete.

IMPORTANT: If you turn on the GoHighLevel integration (see the section below), ReferralHero will populate the custom fields in your GoHighLevel account with the subscriber's values.

Automatically Add New GoHighLevel Contacts to ReferralHero

Step 1: Install GoHighLevel Tracking Code

To ensure accurate tracking of contacts, install the GoHighLevel tracking code on your website:

1. Log in to your GoHighLevel account.

2. Go to Settings → External Tracking → External Tracking Script Installation.

3. Copy the tracking script and embed it on your website.

Step 2: Configure Contact Creation Tracking

ReferralHero’s GoHighLevel Contact Created event automatically identifies whether new contacts are organic subscribers or referrals, and adds them to your ReferralHero campaign.

1. In ReferralHero, navigate to Edit Campaign → Integrations → GoHighLevel.

2. Click Connect your GoHighLevel account.

1. Choose the GoHighLevel account you want to connect.

2. Toggle on Enable GoHighLevel Integration.

3. In the GoHighLevel Events section, click Add Event to Track.

4. Select Create Contact as the GoHighLevel Event Type.

5. Give the event a name.

6. In Trigger Event Type, choose whether to:

   • Add Organic Subscribers and Referrals

   • Add Referrals Only

7. Click Start Tracking.

Automatically Created Custom Fields in GoHighLevel

When the integration is enabled, the following custom fields will be created in your GoHighLevel account:

SUB_ID	Subscriber's id
EX_FIELD	Subscriber's extra field value
EX_FIELD_2	Subscriber's second extra field value
OPTION_FIELD	Subscriber's option field value
CODE	Subscriber's unique referral code
FB_LINK	Subscriber’s Facebook link
TW_LINK	Subscriber’s Twitter link
EM_LINK	Subscriber’s email link
REF_LINK	Subscriber's unique referral link
TOT_REF	Subscriber's total number of referrals
LAST_REF	Timestamp of last referral
MWR	Subscriber’s referrer’s referral code
POSITION	Subscriber’s position
POINTS	Subscriber’s total accumulated points
REFERRER	Subscriber’s referrer’s name
REFERRER_EMAIL	Subscriber’s referrer’s email

Now when a person signs up for your ReferralHero campaign, they will be immediately added to your GoHighLevel account.

NOTE: ReferralHero will automatically update these custom fields when a person signs up or when things change (eg: when a subscriber refers a new person, their TOT_REF value changes).

How to Use Your Own GoHighLevel Signup Form

While the Contact Created event is recommended, high-volume forms (100+ new contacts/day) can be tracked using a redirect URL and ReferralHero JavaScript on a thank-you page.

Step 1: Create a Custom Thank-You Page

1. Create a thank-you page on your website.

2. Add one of the following ReferralHero JavaScript codes to your thank-you page.

Option 1: Use RH.form.submit() to add both organic and track referrals to the referral campaign

<script>
(function () {
 function getQueryParam(param) {
   return new URLSearchParams(window.location.search).get(param);
 }

 const email = getQueryParam("email");
 const firstName = getQueryParam("firstName") || "";
 const lastName = getQueryParam("lastName") || "";
 const phone = getQueryParam("phone") || "";

 const referralHeroData = {
   email: email,
   phone_number: phone,
   name: `${firstName} ${lastName}`.trim()
 };

 function sendReferralData() {
   if (typeof window.RH_MF5f3db1d68d !== "undefined" && email) {
     window.RH_MF5f3db1d68d.form.submit(referralHeroData);
     console.log("ReferralHero data submitted successfully.");
   } else {
     console.log("ReferralHero not loaded or email missing.");
   }
 }

 const checkRHLoaded = setInterval(function () {
   if (typeof window.RH_MF5f3db1d68d !== "undefined") {
     clearInterval(checkRHLoaded);
     sendReferralData();
   }
 }, 300);
})();
</script>

Option 2: Use RH.pendingReferral() to track only referrals with ‘Pending’ status to the multi-step conversion event campaign

<script>
(function () {
 function getQueryParam(param) {
   return new URLSearchParams(window.location.search).get(param);
 }

 const email = getQueryParam("email");
 const firstName = getQueryParam("firstName") || "";
 const lastName = getQueryParam("lastName") || "";
 const phone = getQueryParam("phone") || "";

 const referralHeroData = {
   email: email,
   phone_number: phone,
   name: `${firstName} ${lastName}`.trim()
 };

 function sendReferralData() {
   if (typeof window.RH !== "undefined" && typeof window.RH.pendingReferral === "function" && email) {
     window.RH.pendingReferral(referralHeroData);
     console.log("ReferralHero data submitted successfully.");
   } else {
     console.log("ReferralHero not loaded or email missing.");
   }
 }

 const checkRHLoaded = setInterval(function () {
   if (typeof window.RH !== "undefined" && typeof window.RH.pendingReferral === "function") {
     clearInterval(checkRHLoaded);
     sendReferralData();
   }
 }, 300);
})();
</script>

Step 2: Configure Your GoHighLevel Form

1. Go to your GoHighLevel Form → Settings.

2. Select Redirect to URL from the On Submit dropdown.

3. Enter your custom thank-you page URL with parameters:

https://mywebsite/thankyoupage?email={{contact.email}}&firstName={{contact.first_name}}&lastName={{contact.last_name}}&phone={{contact.phone}}

1. Save the form

New form submissions will now be added to both your GoHighLevel contact list and ReferralHero campaign.

Track a GoHighLevel Conversion Event

You can trigger actions in ReferralHero when GoHighLevel contacts undergo an Opportunity Status or Opportunity Stage change.

1. Go to the GoHighLevel Integration page in ReferralHero.

2. Click Add Event To Track.

3. Enter a name for the event.

4. Select the GoHighLevel event type to track (e.g., Opportunity Status or Opportunity Stage ).

5. Choose the specific status or stage that triggers the event.

6. Select the Trigger Event Type based on the action you want ReferralHero to perform.

Available ReferralHero Actions:

• Add organic subscribers and referrals

• Add referrals only

• Update total spend

• Change referral status (most common use case)