Skip to main content
All CollectionsIntegrations & AutomationsHubSpot And Referral Factory
How To Sync HubSpot Contacts with Referral Factory (and Generate Their Referral Links)
How To Sync HubSpot Contacts with Referral Factory (and Generate Their Referral Links)

Generate referral links and send them along with each referrer's stats back to HubSpot for easy distribution from within your CRM.

Updated over 4 months ago

Sync your HubSpot contacts to generate unique referral links for each of them. Send these links along with each referrer's stats back to HubSpot for easy distribution and monitoring of your referral program within your CRM.

This guide will show you step by step how to successfully sync your HubSpot contacts with your referral program.

Step 1: Create A Custom Property in HubSpot

→ Before you configure the sync between Referral Factory and HubSpot, you will need to create a custom property in HubSpot to store each contact's Referral Link.

→ You may also want to create properties to store each referrer's performance metrics, i.e. the number of people they have referred [Referral Count] and the number of those referrals that have been successful [Converted Referral Count].

Step 2: Start Your Sync in Referral Factory

You can sync your HubSpot contacts from two places in Referral Factory:

From the Promote section inside the campaign builder → Click Generate referral links for your contacts by syncing them.


From the Users Tab → Click Add Users → Click Sync Your CRM Contacts.

Step 3: Choose The Contacts You Want to Sync

→ Choose if you want to sync all your contacts or a list of contacts. You can sync active or static HubSpot lists with Referral Factory.

→ Click Next.

💡 If you recently created lists or properties in HubSpot and they are not showing as an available option for selection in Referral Factory, try clicking the refresh icon.

Step 4: Map Your Fields From HubSpot To Referral Factory

→ Map the property fields from HubSpot to the relevant data fields in Referral Factory.

→ Click Next.

Step 5: Map Your Fields From Referral Factory To HubSpot

→ Map the data from Referral Factory to the properties you have created in HubSpot. To surface each contact's referral link inside HubSpot, you must map the field "Referral Link".

→ Click Next.

Step 6: Confirm (With The Option To Sync Ongoing)

→ In the final step, you have the option to make the sync function on an ongoing basis. Use the toggle to make the sync ongoing.

→ Click Start Sync.

❗️Contacts that you sync will not be automatically notified or sent their referral link, even if your email notification for the person referring is switched on. If you would like to notify them, please use your own marketing channels or Referral

❗️This is not a two-way sync. In other words, direct users who sign up for a referral link via the Pages for the Person Referring will not be automatically added to HubSpot. Should you wish to set up this function, you can do so on the Integrations step of the Campaign Builder by scrolling down to the section titled Person Referring (send direct users into HubSpot).

📌 You can stop the ongoing sync from the Promote section of the campaign builder. Learn more.

HubSpot Sync FAQs

How long does it take to sync HubSpot contacts?

This depends on the number of contacts you’ve synced and how busy the platform is at the time of your sync. Please note that for lists of over 1000 contacts, your sync can take up to 12 hours.

What is the difference between an active and a static HubSpot list?

Active lists in HubSpot automatically update based on criteria you set, while static lists require manual additions and removals. Many Referral Factory clients sync an active HubSpot list on an ongoing basis, meaning that whenever a contact reaches a certain deal stage or similar status, they are automatically added to the list and enrolled in the referral program.

How do you stop an ongoing sync?

→ From the Campaigns Tab, click Edit Campaign to enter the campaign builder.

→ If you have an active, ongoing sync, you should see a green toggle underneath the block titled “Generate referral links for your contacts by syncing them” in the Promote section.

→ Click this toggle to stop the ongoing sync.

Did this answer your question?