Hubspot

This integration is provided as an Open Authorization API (OAA) connector package. Contact our support team for more information.

Veza HubSpot Connector

Python connector for HubSpot to collect teams, roles and users data for the Veza Open Authorization (OAA) API.

Veza Application Mapping

HubSpot	OAA Application	Notes
Instance	Application
Teams	Local Groups
Roles	Local Roles
Users	Local Users

Discovered Properties

Entity	Property	Description
User	email	User's email address
User	primary_team_name	User's primary team name
User	secondary_team_name	User's list of secondary team names
User	role_name	User's role
Group	id	Team's ID provided by HubSpot
Group	name	Team's name
Role	id	Role's ID provided by HubSpot
Role	name	Role's name

Setup

HubSpot

1. To generate access token, we need to create private app in HubSpot.

   • Please follow the given steps in Create Private App

Veza

1. Generate an API key for your Veza user. API keys can be managed in the Veza interface under Administration -> API Keys. For detailed instructions consult the Veza User Guide.

Running the Connector

Command Line

1. Install the requirements:

   pip3 install -r requirements.txt

2. Set the Secrets:

   export VEZA_API_KEY="XXXXXXX...XXXXXXXXXXXX"
   export HUBSPOT_ACCESS_TOKEN="XXX...XXXXXXXXXXXX"

3. Run the connector:

   ./veza_hubspot.py --private-app-name <private app name> --veza-url <URL to Veza instance>

Parameters

CLI Parameter	Environment Variable	Description
--veza-url	VEZA_URL	URL of Veza system
	VEZA_API_KEY	API key for Veza connection
n/a	HUBSPOT_ACCESS_TOKEN	HubSpot Access Token to Authenicate.
--private-app-name	HUBSPOT_PRIVATE_APP_NAME	HubSpot Private App Name
--debug		Enable verbose debug output
--save-json		Save OAA Payload as local JSON file before upload