Introduction

HubSpot is a CRM platform that connects everything scaling companies need to deliver a best-in-class customer experience into one place. HubSpot's integrated CRM platform contains the marketing, sales, service, operations, and website-building software you need to grow your business. SigningHub allows its users to use third party services along with SigningHub. HubSpot is one of these third party services that is supported by SigningHub. In this section you will learn about configuring your HubSpot private app, creating a property in your private app and integration with SigningHub.

How it works?

  1. Visit the HubSpot website and create an account. 
  2. Create a private app by providing the "Basic Information" and select "Scopes". 
  3. Create a property in HubSpot.


Create an account on HubSpot

  1. Go to the HubSpot pricing page by clicking on the following URL:
    https://www.hubspot.com/pricing



  2. Click on the "Free Tools" tab.



  3. Click on the "Get started free" button at the centre of the screen.



  4. Create a new account by providing your "First name", "Last Name", "Email address", and then clicking on the "Next button. Provide all the information required in the upcoming screens.  



  5. Verify your email by entering the code, sent to your email address, in the field below. Click on the "Verify email" button after entering the code.



  6. Create a password for your account and click on the "Next" button.



  7. Select an option for where you would like your data to be hosted, and click the "Create Account" button.



  8. Select your preferences as per the questions being asked on the following screens.



  9. Once done with the account set up process, click on the "Marketing Hub Free" tab from the left panel.


Create a private app on HubSpot

  1. Click on the "Settings" icon, from the page header. From the left panel, select "Integrations" and then "Private Apps" from the drop down.



  2. Click on the "Create a private app" button.



  3. Provide the basic information and click on the "Scopes" tab.



  4. Select the "Read" or "Write" checkbox for each scope that you want your private app to be able to access. You can also search for a specific scope using the "Find a scope" search bar.


  1. The following mentioned scopes are required for the app:
    • crm.objects.contacts.read
    • crm.objects.contacts.write
    • crm.objects.companies.read
    • crm.lists.read


  1. After you are done configuring your app, click on the "Create app" button on the top right of the screen.


  1. Click on the "Continue creating" button.



  2. Your app will be created and access token will be generated. Copy the access token for future use. Click on the "Skip for now" button.



  3. The app details page will appear.


Create a property in HubSpot

  1. Click on the "Contacts" tab in the header, and select "Contacts" from the drop down.



  2. Click on the "Actions" button, and select "Edit properties" from the drop down.



  3. Click on the "Create property" button.



  4. Create a property having "account_title", as label, with the following shown information in each step. 
    After filling the basic information, click on the "Next" button.



After selecting the field type, click on the "Next" button.



After selecting the property rules, click on the "Create" button.



  1. Your property will be created.




Create a HubSpot connector

  1. Access the SigningHub Admin portal.
  2. Click the "Configurations"section from the left menu.
  3. Click the "Connectors" tab. The "Connectors" screen will appear.
  4. Click  from the grid header.



  5. A dialog will appear to add the connector details. The connector dialog is comprised of two screens, i.e. Basic Information and Details. Specify the basic information and click the "Next" button to provide the respective connector details. See the below table for fields description.




     
  6. Click the "Finish" button. A new connector will be saved and displayed in the list.


Basic Information

Fields

Description

Name

Specify a unique name for this connector, i.e. My HubSpot. This connector will be used in the configuration of Global Settings.

Provider

Select the provider for this connector, i.e. "HubSpot". 

Purpose

This field will display the purpose of the selected provider above.

Active

Tick this check box to make this connector active. Inactive connectors cannot be configured in the Global Settings.


Details

Fields

Description

Logo

Select an appropriate image in the jpeg, jpg, gif or png format for the connector's logo that will be displayed on the login screen.

Access Token

Specify the registered Access Token that has been provided by HubSpot to connect to the HubSpot server, i.e. "PyIE9KFm068PbsRf0fKaN2Ek9b53sYySh".


Configure the HubSpot Connector as Default in the SigningHub Global Settings

  1. Click the "Configurations" option from the left menu.
  2. Click the "Global Settings" option.
  3. Global Settings will appear, select the "Default Connectors" option from the top right drop down. 
  4. Configure these settings as required and click the "Save" button from the screen bottom. 
  5. Select the default HubSpot connector for your SigningHub deployment. The selected connector will be used to communicate with the HubSpot server. When configured, the end user while singing up for the new registration will see an optional checkbox, whether they want to receive the promotional/ marketing emails from SigningHub or not. The HubSpot connectors are managed through the connectors section, see details.

 


  1. Once the Default HubSpot Connector has been configured in the SigningHub Global Settings:
    • New registered users will be pushed into HubSpot contacts upon user "Activation". 
    • The user information and the contact property "Lifecycle Stage", will be updated in HubSpot as follows:
      • Customer - A user who has billing (online/offline) enabled on their account.
      • Subscriber - A user who does not have billing (online/offline) enabled on their account.
      • Opportunity - An enterprise user.
      • Other - If the user does not fall in any of the above categories.
    • On deleting the user, the contact will also be deleted from HubSpot.

See Also