HubSpot

​

What’s Supported

​

Supported Actions

The Hubspot connector supports:

• Read Actions, including full historic backfill and incremental reads
• Write Actions.
• Proxy Actions, using the base URL https://api.hubapi.com.

​

Supported Objects

The Hubspot connector supports writing to and reading from the following objects:

• Companies
• Contacts
• Deals
• All other standard CRM objects
• Custom CRM objects

For each of these objects, the connector supports:

• Standard fields
• Custom fields

​

Example Integration

For an example manifest file of a Hubspot integration, visit our samples repo on Github.

​

Before You Get Started

To integrate HubSpot with Ampersand, you need to Create a HubSpot Account and obtain the following credentials from a HubSpot App:

• Client ID
• Client Secret
• Scopes Requested

​

Create a HubSpot Account

You need a HubSpot account to connect with Ampersand. If you do not have a HubSpot account, here’s how you can sign up:

• Go to the HubSpot Developer site and sign up for a free developer account.
• Sign up using your preferred account.
• Verify your email and complete the registration process.

​

Creating a HubSpot App

Once your HubSpot Developer account is ready, you need to create a HubSpot application. Learn more about creating a HubSpot application here.

1. Log in to Your HubSpot Developer Dashboard.

2. Click Create an app.

3. In the Basic Info section:

   1. Enter Public app name.
   2. Add Description, Logo, and Support contact info for your app.

4. Click Save changes.

5. Click on the Auth tab to review your Auth settings. This section includes the client ID and client secret which you need to add to the Ampersand console while setting up hubspot in Ampersand. You’ll need this information for initiating an OAuth connection between your app and HubSpot.

6. In the Redirect URLs section, add the Ampersand Callback URL: https://api.withampersand.com/callbacks/v1/oauth.

7. In the Scopes section, select the scopes you’d like to use in your application. You will need add the same scopes in Ampersand to set up your app.

8. Click Save changes.

​

Obtaining Client Id, Client Secret, and Scopes section

Here’s how to grab the credentials you’ll need:

1. Go to Manage Apps in HubSpot and select your app.
2. Click on the Auth tab.
3. You will find your Client ID and Client Secret under the App Credentials section.
4. The Scopes section lists the permissions your app has in HubSpot.

​

Add HubSpot App Details in Ampersand

❕ Before adding the HubSpot App Details in Ampersand, ensure you have obtained the client ID, client secret, and scopes from HubSpot.

For instructions on how to obtain these details, refer to the section on Obtaining Client ID, Client Secret, and Scopes .

1. Log in to your Ampersand Dashboard.

2. Select the project where you want to add the Hubspot App.

3. Select Provider apps.

4. Select HubSpot from the Provider list.

5. Enter the previously obtained Consumer Key in the Client ID field and the Consumer Secret in the Client Secret field.

6. Enter the scopes set for your application in HubSpot.

7. Click Save changes.

​

Using the connector

To start integrating with Hubspot:

• Create a manifest file like the example, see Define Integrations for more info.
• Deploy it using the amp CLI.
• If you are using Read Actions, create a destination.
• Embed the InstallIntegration UI component.
• Start using the connector!
  • If your integration has Read Actions, you’ll start getting webhook messages.
  • If your integration has Write Actions, you can start making API calls to our Write API.
  • If your integration has Proxy Actions, you can start making Proxy API calls.