Lead scores in HubSpot

Why use predictions for lead scores?

Knowing which leads are worth chasing–and which aren't–is key to keeping your teams focused and efficient in driving revenue.

The most effective way to predict a lead's likelihood to buy is with machine learning. With machine learning, you can ingest your lead lists as they come in, predict their likelihood to buy based on the historical data of similar shoppers, and plug the highest-scoring leads right back into your stack, no PhD required. No more time wasted on leads that were never going to convert in the first place.

Faraday makes predicting likelihood to buy for your leads intuitive & easy, and delivering them to any channel in your stack a breeze.

With lead score predictions in HubSpot, you'll give your team the ability to focus on only the leads most likely to convert.

Follow the steps below to get your lead scores predictions into your HubSpot account.


In this guide, we'll show you how to:

  • Organize your customer data into cohorts
  • Describe predictive models for lead scores with outcomes
  • Deploy lead scores predictions to HubSpot using Pipelines

Getting started with lead scores in HubSpot

Make sure you have a Faraday account (signup is free!) and that it's not in test mode.

Requirements for this lead scores recipe

You'll need the following cohorts available in your Faraday account:

Screenshot of the cohorts listing that includes Leads and Customers

Building predictions for lead scores in HubSpot

Now you'll create the prediction objective(s) necessary to complete this use case with Faraday.

Describe your lead scores predictions with outcomes

Outcomes use machine learning to predict whether or not people will exhibit a certain behavior.

Creating an outcome for likelihood to convert.

Let's make an outcome for likelihood to convert.

  • In the navigation sidebar, choose Outcomes. Screenshot of the outcomes list
  • Click the New outcome button.
  • Fill out the form:
    • For Eligibility cohort, pick the cohort that best represents your leads.
    • For Attainment cohort, pick the cohort that best represents your customers.
    • Leave Attrition cohort blank.
    • Skip over Trait blocking.
    • Enter a memorable name, like "Likelihood to convert". Screenshot of the new outcome form, filled out
  • Click the Save outcome button.

Faraday will do some magic in the background, so you can proceed with the rest of the instructions. When your outcome is done building, you'll get an email, and you can review your outcome.

Using Pipelines to deploy predictions to your stack

Now you'll configure the pipeline that deploys your predictions to hubspot.

Create your pipeline for lead scores in HubSpot

  • In the navigation sidebar, choose Pipelines. Screenshot of the pipelines list
  • Click the New Pipeline button.
  • Fill out the form:
    • For Payload, choose the following:
      • Outcome: Likelihood to convert
    • For Population to include, choose the following:
      • A cohort representing your leads
    • Enter a memorable name, like "Lead scores in HubSpot". Screenshot of the new pipeline form, filled out
  • Click the Save pipeline button.

Your pipeline will start building in the background. You can proceed immediately with the next set of instructions.

Deploying your pipeline to HubSpot

CSV

  • In the Deployment area, find the CSV module and click Add. Screenshot of the ready pipeline with no targets yet
  • Fill out the popup:
    • Choose the Identified option.

    • Choose Human friendly column headers.

  • Click the Next button. Screenshot of the new target form, filled out
  • Expand the Structure section of Advanced Settings
    • From the dropdown, select the hubspot preset. Screenshot of the second page of the new target form, filled out
  • Click the Finish button.
  • Click the Test deployment button and confirm the results meet your expectations. Screenshot of a target after hitting its test button the first time Faraday will finish building your pipeline in the background. When it's done, you'll get an email—return to the pipeline and click the Enable pipeline button to activate it.

How to use your lead scores predictions in HubSpot

With your pipeline deployed, it's time to plug your lead scores into HubSpot. Follow the steps below to see each HubSpot contact enriched with their lead score.

Importing your lead score CSV into HubSpot

  1. In your Faraday pipeline, click the Download CSV button under the deployment to download your lead scores as a CSV.
  2. Navigate to HubSpot's import wizard via Contacts > Contacts > Import, select start an import on the left, and click next.
  3. Select file from your computer on the left, since you're uploading a contact list that you intend to reach out to, rather than the other option of an opt-out list. Click next.
  4. Select one file and click next.
  5. Select one object, as we're only handling contact data. Click next.
  6. Select contacts, and keep selections in "activities" blank. Click next.
  7. Select your CSV, and click next.
  8. In data mapping, ensure email is matched correctly, as it is used by HubSpot to match contacts in your CSV to their HubSpot record.

hubspot import mapping

Under the "Import as" column, key rows to map to "Contact properties" are email and the percentile row outlined in step 9.

  1. In the final row, "fdy_outcome_propensity_percentile", ensure the "Import as" column selection is contact properties, click choose or create property, then create a new property.
  2. Under "Group", select contact information, as the property you're creating is for the contact card.
  3. Give the new property an appropriate label, such as "Lead score."
  4. Optionally give the new property a description,, such as "Faraday's lead score, or the percentile the lead is in based on their predicted likelihood to buy." Click next.

new hubspot property

  1. Change "field type" to number under "values," as the percentile is numeric. Click next.
  2. Click create to finish creating the new HubSpot property for percentile, and ensure the new property is selected in the final row (step 9).
  3. Click next to move onto the final stage of the import, where you can name the import.
  4. If desired, tick the box for create a list from this import, which will save you a step when preparing to launch a campaign to target these likely-to-buy leads. Additionally, you can tick set these contacts as marketing contacts so that they are able to receive communication from you.
  5. Click finish import to wrap up. If you ticked the box to create a list in step 16, you can begin to plan a campaign to target the leads in this list.

🔒 It's a best practice to permanently delete any file that contains personally identifiable information (PII) after use. Any deployment from Faraday that is unhashed contains PII, and should be deleted after uploading it to your destination for security purposes.