Adding your HubSpot credentials to Oomnitza

Best practice
For the integration with Oomnitza, create a dedicated user account.

Prerequisites 

HubSpot uses OAuth authentication and requires your Client ID and Secret to be added to Oomnitza.

To generate your Client ID and Secret, you must have a HubSpot Developer Account. Since HubSpot users are not automatically given a Developer Account, you might need to create one. To create a Developer Account, visit the Hubspot Developers site. Click Create a Developer account > Create App Developer account and follow the subsequent steps to complete the setup.

The app you'll be creating (as outlined in the steps below) is a public app. For further details, see HubSpot Developer Docs: Public apps.

Procedure

1. Log in to your HubSpot Developer Account.
2. Click Create an App.
3. Enter an app name and description.
4. In the Auth tab, supply the following redirect URL: https://generic-oauth2-proxy.oomnitza.com/oauth2/redirect_url
5. For the Scopes, select content actions oauth settings.users.read settings.users.write account-info.security.readfollowing the example below.
6. Copy your Client ID and Secret.
7. Click Save.

Next, you need to install the app on a Developer test account. Complete the following steps:

1. From the menu, click Testing.
2. Click Create app test account.
3. Name your account and click Create

Important
If you try and authenticate in Oomnitza without completing the final step of installing the app on a Developer test account, you will get the following error or similar The account you selected is a developer account. This app can't be installed. See Hubspot Community: OAuth error 

Adding your HubSpot credentials

To stream HubSpot user data into Oomnitza, complete the following steps:

1. In Oomnitza, click Configuration > Security > Credentials.
2. Click Add new credential (+).
3. Search for the integration, and then click the forward arrow > to select the integration. 
4. Enter your client credentials and any other additional information.
5. Click Authenticate. You are prompted to log in to authorize your request.
6. Click CREATE.

1. Add the information details.
2. Click the AUTHORIZATION tab.
3. Ensure that OAuth 2.0 is selected as the Authorization type.
4. Ensure that HubSpot is selected from the SaaS list.
5. Enter your client ID and client secret.
6. Enter a space-separated list of scopes, i.e. content actions oauth settings.users.read settings.users.write account-info.security.read
   
7. Click Authenticate.
8. Click the radio button next to your app and click Choose Account.
9. Click Connect App.
10. Click CREATE. 

Documentation:

HubSpot API Documentation

Next steps

Now that you have added your GitLab credentials to Oomnitza, you can run the  extended integration for HubSpot users