HubSpot

Inbound Marketing, Sales, and Service Software

Go to site
Explore
/
Apps
/
HubSpot

HubSpot API Integrations

Build and run workflows using the HubSpot API. Use 1000s of open source triggers and actions across 800+ apps. Or write custom code to integrate any app or API in seconds.

Overview

The Pipedream HubSpot app enables you to build event-driven workflows that interact with the HubSpot API. We have a variety of pre-built triggers and actions that don't require any code to configure.

import { axios } from "@pipedream/platform"
export default defineComponent({
  props: {
    hubspot: {
      type: "app",
      app: "hubspot",
    }
  },
  async run({steps, $}) {
    return await axios($, {
      url: `https://api.hubapi.com/integrations/v1/me`,
      headers: {
        Authorization: `Bearer ${this.hubspot.$auth.oauth_access_token}`,
      },
    })
  },
})

Getting Started

Connecting HubSpot to Pipedream

You can install the Pipedream HubSpot app in the Accounts section of your account, or directly in a workflow.

Accounts

  1. Visit https://pipedream.com/accounts.
  2. Click on the Connect An App button in the top-right.
  3. Search for "HubSpot" among the list of apps, and select it.
  4. You will be prompted to sign in to HubSpot and select the account you'd like to connect.
  5. Finally, HubSpot will ask to give Pipedream access to your account. Click "Connect app" to proceed.
  6. That's it! You can now use this HubSpot account to trigger a workflow, or link it to any code step.

Within a workflow

  1. Create a new workflow.
  2. Search for "HubSpot" in the text field when selecting a trigger.
  3. Select the one of the triggers that appear, based on your use case.
  4. Click the Connect Account button near the top of the trigger. This will prompt you to select any existing HubSpot accounts you've previously authenticated with Pipedream, or you can select a New account. Clicking New opens a new window asking you to allow Pipedream access to your HubSpot account.
  5. That's it! You can now connect to the HubSpot API using any of the HubSpot triggers within a Pipedream workflow.

Privacy Policy

Please see the Pipedream Privacy Policy for a detailed description of how we manage your data.

Troubleshooting

Please reach out to the Pipedream team with any technical issues or questions about the HubSpot integration. We're happy to help!

Authentication

HubSpot uses OAuth authentication. When you connect your HubSpot account, Pipedream will open a popup window where you can sign into HubSpot and grant Pipedream permission to connect to your account. Pipedream securely stores and automatically refreshes the OAuth tokens so you can easily authenticate any HubSpot API.

Pipedream requests the following authorization scopes when you connect your account:

business-intelligencecrm.lists.readcrm.lists.writecrm.objects.companies.readcrm.objects.companies.writecrm.objects.contacts.readcrm.objects.contacts.writecrm.objects.deals.readcrm.objects.deals.writecrm.objects.owners.readcrm.schemas.companies.readcrm.schemas.companies.writecrm.schemas.contacts.readcrm.schemas.contacts.writecrm.schemas.deals.readcrm.schemas.deals.writeconversations.readcrm.importfilesformsforms-uploaded-filesintegration-syncoauthtimeline
OAuth Request Configurations:
  1. authorization
    GEThttp://app.hubspot.com/oauth/authorize?client_id={{oauth.client_id}}&redirect_uri={{oauth.redirect_uri}}&state={{oauth.state}}&response_type=code&scope={{oauth.space_separated_scopes}}&optional_scope=automation content conversations.visitor_identification.tokens.create cms.source_code.read_write e-commerce hubdb sales-email-read social tickets transactional-email crm.objects.custom.read crm.objects.custom.write crm.schemas.custom.read crm.schemas.custom.write
  2. accessToken
    POSThttps://api.hubapi.com/oauth/v1/tokencontent-type: application/x-www-form-urlencodedaccept: application/json
    client_id={{oauth.client_id}}&client_secret={{oauth.client_secret}}&redirect_uri={{oauth.redirect_uri}}&grant_type=authorization_code&code={{oauth.code}}
  3. refreshToken
    POSThttps://api.hubapi.com/oauth/v1/tokencontent-type: application/x-www-form-urlencodedaccept: application/json
    client_id={{oauth.client_id}}&client_secret={{oauth.client_secret}}&grant_type=refresh_token&refresh_token={{oauth.refresh_token}}