Setup Guide

You can find your HubSpot application credentials by visiting your HubSpot developer dashboard.

You'll need the following information to set up your HubSpot App with Paragon Connect:

• Client ID

• Client Secret

• Scopes Requested

Prerequisites

• HubSpot Developer Account. You can create one here.

• HubSpot application. Learn more about creating a HubSpot application here.

Add the Redirect URL to your HubSpot app

Paragon provides a redirect URL to send information to your app. To add the redirect URL to your HubSpot app:

1. Copy the link under "Redirect URL" in your integration settings in Paragon. The Redirect URL is:

https://passport.useparagon.com/oauth

2. Log in to your HubSpot developer dashboard.

3. Click Manage apps, then select the app you'd like to connect to Paragon.

4. Under Auth > Auth settings > Redirect URL, paste-in Paragon Connect's redirect URL found in Step 1.

5. Select any scopes you'd like to use in your application.

6. Press the Save button at the bottom of the page.

HubSpot provides your Client ID and Client Secret needed for the next step.

Add your HubSpot app to Paragon

1. Select HubSpot from the Integrations Catalog.

2. Under Integrations > Connected Integrations > {YOUR_APP} > Settings, fill out your credentials from the end of Step 1 in their respective sections:

• Client ID: Found under Auth > Auth settings > Client ID on your HubSpot App page.

• Client Secret: Found under Auth > Auth settings > Client secret on your HubSpot App page.

• Permissions: Select the scopes you've requested for your application.

Press the blue "Connect" button to save your credentials.

Connecting to HubSpot

Once your users have connected their Hubspot account, you can use the Paragon SDK to access the Hubspot API on behalf of connected users.

See the Hubspot REST API documentation for their full API reference.

Any Hubspot API endpoints can be accessed with the Paragon SDK as shown in this example.

// You can find your project ID in the Overview tab of any Integration
​
// Authenticate the user
paragon.authenticate(<ProjectId>, <UserToken>);
             
// List Companies
await paragon.request("hubspot", "/crm/v3/objects/companies", { 
  method: "GET"
});
  
  
// Create Company
await paragon.request("hubspot", "/crm/v3/objects/companies", { 
  method: "POST",
  body: {
    "properties": {
      "city": "Cambridge",
      "domain": "biglytics.net",
      "industry": "Technology",
      "name": "Biglytics",
      "phone": "(877) 929-0687",
      "state": "Massachusetts"
    }
  }
});
    

Building HubSpot workflows

Once your HubSpot account is connected, you can add steps to perform the following actions:

• Create record

• Update record

• Delete record

• Get record by ID

• Search records

When creating or updating records in HubSpot, you can reference data from previous steps by typing {{ to invoke the variable menu.