1. Home
  2. Docs
  3. Implementation Guide: Meta Conversion Leads
  4. Part 2: Connect CRM to Meta Conversion Leads
  5. Step 1 (Option 4): Hubspot CRM Source Connector Setup

Step 1 (Option 4): Hubspot CRM Source Connector Setup


  • Login credentials to HubSpot admin account that is set-up to capture leads from Meta Lead Ads (Instant Forms)
  • A custom field created in HubSpot contact detail page that captures Meta Lead ID from Meta Lead Ads (Instant Forms). The Meta Lead ID field in the Contacts module of Hubspot should be either text or number (not decimal) data type.
  • Minimum two lead life cycle stages/lead status configured in the CRM to be pushed to Conversion Leads

    Implementation Steps on Datahash

    Step 1: Authorization
  • Choose HubSpot under source connector and click on the “Sign in with HubSpot” Single Sign-On button to authorize the connection.

    Step 2: Instance Naming
  • Once the permissions are verified, give a name to identify this connection in the HubSpot source connector as you can create multiple instances within the connector. Example, if you want send New Lead to a different destination than Opportunity, then creating multiple instances would help you with that.  

    Step 3: Field Mapping
    Specify the Hubspot Contacts module columns for Lead Source ID, Last Modified Date and Lead Lifecycle Status data points required to fetch lead data to be pushed to Meta Conversion Leads.

  • Lead Source ID:  This is the unique identifier generated at the source where the lead was captured. For instance, for Facebook leads, the ID would be “Meta Lead ID”. Please select the CRM column name for capturing this ID.
  • Last Modified Date Column: This is the field that indicates the lead’s most recent update time to synchronize the latest updates. Please specify the CRM column name for capturing this update. The default sync frequency is 15 minutes.
  • Lead Lifecycle Status Column: Lead lifecycle status refers to the field in the CRM that is used to track the stages that a lead moves through during the lead lifecycle. Updates in these stages are tracked as events and pushed to a destination. Example, If a status of lead changes from “New Lead” to “Opportunity” we can send that as conversion signals in Meta Conversion Leads for Lead Ads campaign optimisation.

    Click on Preview Data to show values of the selected columns for a sample set of leads from your connected HubSpot account to validate if the field mapping is correct and required data is being fetched.

    Click Proceed to move to the next step of Event Mapping

    Step 4: Event Mapping

    In this step, you’ll need to select the lead stages that you want to send as signals to your desired destination. The lead status event list will be automatically pulled based on the primary event column you selected in the previous step.

    On the first screen, you have two ways to do event selection and mapping

    Option 1: Tracking default event values

    New Lead: This selection helps tracking creation of new lead if the CRM doesn’t assign a default status to the new lead. Uncheck this option if the CRM set-up has a default value for the new lead. The New Lead status typically marks the beginning of your lead lifecycle, such as the default “Open – not contacted” status in Salesforce CRM.

    Track all statuses: This includes all the lead statuses currently available in your CRM. By default, they will all be selected. However, if you only want to track certain statuses, you can uncheck ‘Track all’ option and choose the ones you need to track for Conversion Leads Optimisation. Kindly note ‘Track all’ option will also start tracking all the new status that you will be creating  in the future.

    For better optimization, it’s recommended to track at least two events. To optimize your campaigns effectively, it’s important to track the New Lead event, which is added by default if you’re not already capturing it. You can update it to match your lead statuses.

    Option 2: Tracking custom event values

    If you want to use custom event values to be pushed to Meta Conversion Leads, create custom event mappings. Simply click on the “Click here to use custom event mappings” CTA on the field mapping screen. You’ll see two sets of rows: the left side corresponds to your CRM status values, while the right side lists standardized event values for ease of mapping.

    Again, the left side Lead Status list will be pulled based on the primary event column you selected earlier. Once you’ve chosen your left side row values, you’ll need to map them to the appropriate Datahash values on the right side. This will help us streamline your values for different marketing channels. If you need to add a custom event value which is not in the standard list, simply use the ‘custom event name’ option in the drop-down menu to define your own event value.

    Click Finish to successfully setup your LeadSquared CRM Source Connector.

    Proceed to Step 2 to set-up Meta Conversion Leads as data destination to capture lead status update events through Conversion Leads

How can we help?