Skip to main content

Initial setup for HubSpot Reader

If you plan to authenticate with a private app token, first configure a private app in your HubSpot account so you can provide the token to the Striim wizard. You can also authenticate with OAuth directly from Striim. Optionally, create a reusable Striim connection profile so you don’t re-enter credentials for each application.

Configuring Private App Token authentication

Using private app token authentication for HubSpot requires a private app.

  1. Log in to your HubSpot account.

    HubSpot accounts are distinct from HubSpot app developer accounts. Developer accounts don't have the ability to create private apps. Make sure you are logged in to a standard HubSpot account.

  2. Click the settings icon.

  3. Click Integrations > Private Apps, then click Create private app.

  4. Type basic information and settings for the app. The name, description, logo, and support contact information you use in these fields is visible to users that authenticate this app with their HubSpot account.

  5. Click the Scopes tab.

  6. Select the Read checkbox for each scope the private app needs to access. To find a specific scope, type a search string in the Find a scope search field. Add the required scopes for the objects you plan to ingest (for example, crm.objects.companies.read, crm.schemas.companies.read, and so on).

  7. Click Create app.

  8. On the Access token card, click Show token, then click Copy to copy the token to your clipboard.

Use the token in the clipboard to configure the Striim HubSpot Reader in the Striim wizard.

Configuring a Striim connection profile for HubSpot

Create a reusable connection profile so multiple applications can share the same validated HubSpot credentials.

  1. In the Striim UI, go to Admin > Connection profiles and click New.

  2. Select HubSpot Reader (source) as the connector type.

  3. Choose an authentication method:

    • Private app token: Paste the token you created in HubSpot.

    • OAuth: Enter Client ID, Client secret, and Refresh token.

  4. Optionally set Connection pool size and other advanced properties as needed.

  5. Click Test to validate, then click Save. The profile appears in the list.

  6. When building an app, set Use connection profile to True in the HubSpot Reader properties and select your Connection profile name from the drop-down.

Using connection profiles simplifies rotation of credentials and promotes consistency across environments.