Wiki source code of Hubspot Integration Setup

Version 3.1 by Admin User on 2026/03/20 17:17

author	version	line-number	content
		1	HubSpot Integration:
		2
		3	HUBSPOT: API SETUP
		4
		5	The API in Hubspot is called a Private App. To give ONEcount access to your Hubspot installation, you to create a private app called "ONEcount Integration" with the following scopes:
		6
		7	contacts ~-~-> read, write,
		8	lists ~-~-> read,write
		9	company ~-~-> read write
		10	content → read, write
		11	remaining all read
		12
		13	[[image:hubspot-integration_e2fc744571ec77a0.png\|\|height="307" width="665"]]
		14	\\
		15
		16	[[https:~~/~~/developers.hubspot.com/scopes>>url:https://developers.hubspot.com/scopes]]
		17
		18	Here is documentation from the Hubspot site on how to do it: __[[https:~~/~~/developers.hubspot.com/docs/api/private-apps>>url:https://developers.hubspot.com/docs/api/private-apps]]__
		19
		20	Once you have created this in HubSpot, send us the Access Token for this private app and ONEcount will be able to pull your enagement data. The token will look like this:
		21
		22	EXAMPLE: vat-ma1-936fe9d7-d41b-4bb6-91e2-d82c951exxde
		23
		24	Please note that Hubspot accounts have a limit on the number of API calls you can make. ONEcount typically makes 10 to 20 calls per day to fetch engagement data. In addition, each time a user is added to your Hubspot lists (either individually through a web sign-up or in bulk through a bulk operation), we make an API call. In addition, when a user who is unknown clicks on an email link, we will make an API call to look up that user in your database.
		25
		26	As a practical matter, you should not exceed your Hubspot limits, however during the first month or so of deployment, please monitor your usage to avoid fees from Hubspot.