Skip to main content

Checklist before installing a HubSpot integration

We recommend verifying the following requirements before installing the HubSpot integration to ensure a smooth setup.

1. Ensure you are a HubSpot Super Admin

You must be a Super Admin to install an app. This is a HubSpot requirement.

2. Ensure you have a Sales Hub seat (if access to Leads is required)

If your integration requires access to Leads, you must have a Sales Hub seat in HubSpot. Without this, you may not be able to retrieve or manage lead data. To check if you have a Sales Hub seat:
  1. Log in to HubSpot.
  2. Click on your profile picture and select Settings.
  3. In the left sidebar, navigate to Users & Teams.
  4. Locate your user account and check for Sales Hub seat assignment.
  5. If you do not have a Sales Hub seat, ask your HubSpot administrator to assign one to you.
Learn more about different HubSpot seats here.

Set up a private app for custom field changes

If the app you’re integrating with needs to know when custom fields change in HubSpot, it asks you to create a private app in your HubSpot account. You must be a HubSpot Super Admin.
  1. Get the webhook URL from the app you’re integrating with. It looks like this:
  1. Install the HubSpot CLI, then run hs init to connect it to your HubSpot account.
  2. Create a private app with webhooks. When prompted, enter a name and location for the project:
  1. In the new project, open src/app/webhooks/webhooks-hsmeta.json. Set targetUrl to the webhook URL from step 1, and add an object.propertyChange subscription for each custom field you want to track. See HubSpot’s webhooks guide for the file format.
  2. Run hs project upload to deploy the app to your HubSpot account.
  3. In HubSpot, go to Development > Projects. If you don’t see Development in the left sidebar, look under More.
  4. Select your project, then click the app.
  5. On the Distribution tab, click Install now.
  6. Check the acknowledgment checkbox, then click Connect App.
If you see “We’re still setting up this app,” wait a minute and try again.