HubSpot Integration - Contact Creation

Applies to: QLM Enterprise

Version: 15.1.22017.5


Overview

QLM can automatically create a Contact in HubSpot when a customer is created in the QLM Trial Registration Form.

The information transferred to HubSpot is:

  • First name

  • Last name

  • Company

  • Phone

  • Country

  • Default Lead Status

  • Default Lifecycle Stage

Authentication

To authenticate with HubSpot, you need to first get a HubSpot API Key as follows:

  • Log in to your HubSpot account

  • Click the Settings icon in the top toolbar

  • In the left-hand panel, locate the Integrations section and expand it

  • Click Private App

  • Click Create a Private App

  • Set the name of the App

  • In the Scopes section, enable the following scopes: crm.objects.deals.writecrm.objects.deals.readcrm.objects.contacts.readcrm.objects.contacts.write

  • Click Create app

  • A token will be generated. Copy the token and store it in a secure place.

To configure QLM with the API Key created above:

  • Launch the QLM Management Console

  • Go to the Manage Keys tab

  • Click 3rd Party Extensions

  • Locate HubSpot

  • Check Enabled to enable the extension

  • Set the API Key value to the Token created above and click OK

Custom Properties

Next, you must create Custom Properties in HubSpot.

  • Click the settings (gear) icon on the top toolbar

  • Under "Data Management", click Properties

  • In the next step we will create 3 properties:

    • Click "Create Property"

      • Set the Object type to "Deal"

      • Set the Group to "Deal Information"

      • Set the Label to "product_name"

      • Set the Field type to Single-line text

      • Click Next

      • Click Create

    • Click "Create Property"

      • Set the Object type to "Deal"

      • Set the Group to "Deal Information"

      • Set the Label to "activation_key"

      • Set the Field type to Single-line text

      • Click Next

      • Click Create

    • Click "Create Property"

      • Set the Object type to "Deal"

      • Set the Group to "Deal Information"

      • Set the Label to "license_model"

      • Set the Field type to "Dropdown select"

      • Click "Add an option"

      • Set the Label to none and the Internal Value to 0.

      • Set the Label to permanent and the Internal Value to 1.

      • Set the Label to trial and the Internal Value to 2.

      • Set the Label to subscription and the Internal Value to 3.

      • Click Next

      • Click Create

    • Finally, we need to add the properties to the View

      • Select any existing Deal

      • In the left hand panel, click "View all properties"

      • Expand the "Deal information" section

      • Locate the product_name entry and click the "Add to your view" button

      • Locate the activation_key entry and click the "Add to your view" button

      • Locate the license_model entry and click the "Add to your view" button

Enable Contact Creation

Contact creation can be enabled via QLM's Server Properties.

  • Launch the QLM Management Console

  • Go to the Manage Keys tab

  • Click Sites then go to the Server Properties tab

  • Locate the HubSpot section

  • Set the following properties

    • createContactFromTrialRegistration

    • defaultLeadStatus. Possible values: NEW, OPEN, IN_PROGRESS, OPEN_DEAL, UNQUALIFIED, ATTEMPTED_TO_CONTACT, CONNECTED, BAD_TIMING. The values are case-sensitive.

    • defaultLifecycleStage: Possible values: subscriber, lead, marketingqualifiedlead, salesqualifiedlead, opportunity, customer, evangelist, other. The values are case-sensitive.

Last updated