Set up your HubSpot integration and get all the insights in Torii's dashboard

Overview

Torii integrates with your HubSpot account and syncs the list of users and their status.

Note: The role field is synced only for Enterprise HubSpot accounts.

Torii supports the following actions:

1. Create User
2. Delete User
3. Modify User Role - for this action enterprise account is required.

To use these actions, add the settings.users.write scope to your service key. To assign teams when creating a user, also add settings.users.teams.write.

For the Modify User Role action, also add the settings.billing.write scope.

Prerequisites

To connect HubSpot to Torii, you will need the following:

• Super Admin permissions or the Developer tools access permission, to create a service key

• A HubSpot service key

Create a service key

1. In your HubSpot account, navigate to Development
2. In the left sidebar menu, navigate to Keys > Service keys
3. In the top right, click Create service key
4. Enter a name for the service key, for example Torii
5. Click Add new scope and select these scopes:
   • crm.objects.owners.read
   • settings.users.read
   • settings.users.teams.read
   • For actions, also add the scopes listed in the Overview section
6. Click Update, review the selected scopes, then click Create in the top right and confirm
7. Open the service key, click Show and then Copy

Connect HubSpot integration to Torii

1. Go to the Integrations page and select the HubSpot tile
2. Click Connect to HubSpot
3. In Connect Hubspot, paste the service key from the previous steps
4. Click Connect

5. Once the integration is connected and synced, it will display a green checkbox.

   

FAQ

Q: I already connected Torii with a private app. Do I need to change anything?

A: No. As of October 26, 2026, HubSpot no longer allows creating private apps, but existing private apps keep working. If you need to reconnect, you can paste your existing private app token in the Service key field: in HubSpot, go to Development > Legacy apps, click your app, open the Auth tab, click Show token and then Copy.

Q: My integrations has failed with the error "HubsSpot API shared rate limit reached". What does this mean?

A: The HubSpot API has a rate limit that is shared among all private apps for each organization. Altough Torii's HubSpot integration doesn't call the HubSpot API a large number of times, the integration can still fail if you have other private apps set up in HubSpot which are heavily utilizing their API. 

When Torii's Hubspot integration fails this way, we continue to attempt to sync the integration for several days. If a rate limit error persists for more than several days, the integration will be disabled. 

In this case, we recommend looking into and adjusting your private apps in HubSpot, as they are preventing the integration form syncing successfully. Once you've do so, please reconnect the integration.