HubSpot Connector: Setup + FAQs

Setup Guide Overview

This setup guide will require the system administrator to complete steps outlined below in order to connect the external system application with Vertify.

Please note, this document may be subject to change and additional information required. Partnership with system administrator and/or support team may be necessary.

Where do I begin?

STEP 1: CUSTOM FIELD CREATION

Custom fields are required to be created on the Company, Contact, and Opportunity (optional) Objects in HubSpot for the Vertify integration. 

Reference the API Name column in the table below for the list of how to title the fields, the needed data type, and the purpose of the field for context.

STEP 2: CREATING A USER ACCOUNT IN HUBSPOT

1. Please log into Hubspot with your normal credentials. 
2. Create a new User Account in Hubspot that has Admin privileges. 
   1. It should never be deactivated or deleted, and one that can be logged into in order to complete the connection process.
   2. Please use this naming convention for an email: passwords+TENANTNAME@vertify.com 
3. Once the user is created, please log out of your personal account, and log back in with the newly created credentials to ensure it’s ready to be used. 

STEP 3: OAUTH SETUP IN VERTIFY

1. Navigate to your Vertify tenant site provided by your Customer Success Manager. 
   1. Reach out to them directly if you have any questions or need assistance.
   2. Follow the reset password link to pick a permanent password for your account.
2. On the main Dashboard, click Workspaces.
3. Click the Workspace link you want to create a system in.
4. Click New System

5. Select HubSpot from the Remote System dropdown menu, the latest version of the Connector should be defaulted, and then choose BiDirectional from the System Type dropdown.
6. Click Save.

7. A Hubspot box will display at the bottom with a link underneath that says "Connect With HubSpot".
8. If logged into the User Account created for the integration, it should navigate to a page that will have a "Grant Access" button to select. 
   • If not logged into that account already, it will navigate to a page to log into the correct user account or choose the account to grant access to
9. Click the orange button to connect the Vertify App with your HubSpot instance.
10. When you return back to Vertify, click Save at the bottom right-hand corner of the page. 
11. Click Connect - please note that the new Hubspot system will display in orange and the status will be 'Scan Failed'. That’s normal!
12. Click the arrow on the far left-hand side to expand the error message, and click the check box. Press Scan again. When it completes, you should see a Scan Complete status update.

13. Let your Vertify specialist know when this is completed!

___

Disconnect / Reconnect to HubSpot

If a different HubSpot User Account needs to be connected to your instance of Vertify, please follow the steps below to disconnect the old account and then reconnect to the new account. This can all be done within the existing HubSpot System Connect page.

1. Find the HubSpot system under the Systems page, click Edit.
2. Navigate to the HubSpot box at the bottom of the Systems page that has a link underneath that says Disconnect HubSpot.
3. Click the link to Disconnect, Save.
4. Click Connect With HubSpot.
5. Next, if logged into the User Account created for the integration, it should navigate to a page that will have a "Grant Access" button to select. 
6. If not logged into that account already, it will navigate to a page to log into the correct user account or choose the account to grant access to
7. Click the orange button to connect the Vertify App with your HubSpot instance.
8. When you return back to Vertify, click Save at the bottom right-hand corner of the page. 
9. Click Connect to return back to the Systems page, review the status of the HubSpot system - please note that the new HubSpot system will display in orange and the status will be 'Scan Failed'. That’s normal!
10. Click the arrow on the far left-hand side to expand the error message, and click the check box. Press Scan again. When it completes, you should see a Scan Complete status update.

Objects

These objects are commonly integrated:

• Company (Read/Write)
• Contact (Read/Write)
• Owner (Read)
• Engagement (Read)
• Deal (Read/Write)
• Lead (NEW 2025 - availability of object relies on HubSpot subscription, connect with your Vertify team to get more information on how to access new object in Vertify and review the system's readme file)