HubSpot

​

What’s Supported

​

Supported Actions

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

​

Supported Objects

• Companies
• Contacts
• Deals
• Emails
• Calls
• Meetings
• Notes
• All other standard CRM objects
• Custom CRM objects

• Standard fields, here’s a list of the standard fields for common Hubspot objects
• Custom fields

• Lists. Please note that for Lists, incremental reads is not supported, which means that a full read of all Lists is done for each scheduled read. Incremental read is supported for other objects listed above.
• Users and owners, please refer to the section below.

​

Reading users and owners

        - objectName: users
          destination: defaultWebhook
          schedule: "0 0 * * *" # every day
          requiredFields:
            - fieldName: hs_object_id
              mapToName: userId
            - fieldName: hubspot_owner_id
              mapToName: ownerId
            - fieldName: hs_email
              mapToName: emailAddress
            - fieldName: hs_family_name
              mapToName: lastName
            - fieldName: hs_given_name
              mapToName: firstName
            - fieldName: hs_createdate
              mapToName: createTime
            - fieldName: hs_lastmodifieddate
              mapToName: updateTime
            - fieldName: hs_deactivated
              mapToName: isDeactivated   

​

Example Integration

​

Before You Get Started

• Client ID
• Client Secret
• Scopes Requested

​

Create a HubSpot Account

• 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

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

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

• Create a manifest file like the example.
• Deploy it using the amp CLI.
• If you are using Read Actions or Subscribe Actions, create a destination.
• Embed the InstallIntegration UI component.
• Start using the connector!
  • If your integration has Read Actions or Subscribe 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.

​

Customer guide