HubSpot provides two ways to authenticate with their APIs:

• OAuth

• Private app access tokens
  

To connect Mavenoid with HubSpot, we recommend using a private app and adding the access token as a secret in Mavenoid.

Using the Call External API action node, with the HubSpot Access Token, Mavenoid can integrate with any of HubSpot's REST APIs.

Obtain the Access Token

1. Create a private app in HubSpot
   Follow this guide from HubSpot for instructions.

2. Choose the permissions (scopes) Mavenoid will need
   If you're unsure which ones to select, contact your Mavenoid representative for help. Usually, we need the following permissions:

   • Read Contacts

   • Write Contacts

   • Write Tickets

3. Copy your private app’s access token
   For more information, refer to HubSpot's article Make API calls with your app's access token.

4. Add the HubSpot access token to Mavenoid
   Refer to our help center article Secrets for information on how to add a secret in Mavenoid.

Important: It's recommended to use a dedicated HubSpot account for this integration. If the account is downgraded or loses access to certain features, the private app will also lose access to those same scopes.

Configure the Integration

Use the Call External API action to integrate with HubSpot's REST APIs. Reference the secret in the header when making the API calls.