​
Setup Guide

​
Prerequisites

Sign up for a free HubSpot Developer account.

​
Step 1: Create a HubSpot Public App

Go to the HubSpot Developer Portal and create a new app. Add the basic app info: name, description, logo. On the auth tab, you will need to provide the Strata OAuth callback endpoint as your redirect URL. This url is also displayed in the Strata dashboard when you create the HubSpot integration. 
https://connect.sandbox.connectstrata.com/oauth/callback
Finally, add your app scopes. In order to use webhooks or API polling to receive CRM events, your app will need to be configured to authorize the Required scopes that correspond to the CRM object type you want to subscribe to. For example, if you want to subscribe to contact events, you would need to request the crm.objects.contacts.read scope.

​
Step 2: Create a HubSpot Integration in Strata

Go to the Strata Integration Catalog and select HubSpot. Input your HubSpot app’s client ID, client secret, and scopes.
It’s important that the scopes provided in the Strata dashboard exactly match the scopes you requested in your HubSpot app.

​
(Optional) Step 3: Configure webhook subscriptions

HubSpot incremental syncs use webhook subscriptions. Subscriptions apply to all customers who have authorized your integration. You can follow the instructions here to create webhook subscriptions in your HubSpot developer account.

​
Integration authorization

Use the Strata SDK to prompt users to authorize your app. Note users must be a Super Admin or have App Marketplace access permissions in order to authorize and app for their HubSpot account.

​
Making Proxy requests

See Proxy API for the full details on how to make a proxy request to the HubSpot API. Here’s an exmaple for HubSpot: 
curl -X GET "https://proxy.sandbox.connectstrata.com/projects/<project_id>/proxy/hubspot/contacts/v1/lists/all/contacts/all?count=1" \
  -H "Authorization: Bearer <user_jwt_token>" \
  -H "Content-Type: application/json"