HubSpot CRM
Use the HubSpot CRM Node to interact with the HubSpot CRM REST API. This Node supports secure OAuth2 authentication and makes it easy to query and manipulate data in standard CRM entities like Contacts, Deals, and Companies - without having to write raw HTTP logic.
Revision History
2.0.0.1 Initial Release
3.0.0.0 Modern OAuth2 authentication, easier setup, and refreshed CRM sample support.
Properties
Connection
Type: Connection Input
The Connection Property, which defines your HubSpot credentials for authentication.
ClientId
Type: String
The Client ID from your HubSpot public application.
ClientSecret
Type: Secret
The Client Secret from your HubSpot public application.
AccessToken
Type: Secret
The token used to authenticate API requests. This is set automatically when you click Connect your Account.
RefreshToken
Type: Secret
The token used to renew the Access Token
when it expires. This is also set automatically when you click Connect your Account.
OperationId
Type: String Input
A unique ID that is automatically populated when you select a sample request from the Samples dropdown.
Name
Type: String Input
Name describing the selected sample.
Request
Type: Multiline Text Input
The JSON payload for the API request. This is used for operations that create or update data in HubSpot.
Response
Type: Multiline Text Output
The Response JSON payload, which contains the full response received from HubSpot.
Custom Inputs
This Node supports Custom Input Properties and the appropriate properties will be added to the Node when a Node Sample is selected. These Properties are resolved into parameters in the URL that is generated for the request. For example, if the operation will query a customer record, the Swagger document may specify the URL template as /customers/{customerId}
. In this case, a Custom Property called customerId
will be added to the Node when a "get customer" Node Sample is selected.
Using the Node
Since v3.0.0.0, the Node now works by using OAuth. This was a necessary change when HubSpot deprecated new API-key creation; OAuth is now mandatory for external integrations, such as Flowgear's Node. This means that the previously available API Key with a private Hubspot application setup is no longer available. Using OAuth with a public Hubspot application is more secure and meets HubSpot's compliance requirements, but does mean that you will need a Hubspot Developer Account.
A public HubSpot application lives inside of a HubSpot Developer Account, which is free and lets you create 10 test accounts. One of these test accounts will be used when using the Node's "Connect your Account" feature. Simply follow the steps below to create this application, copy the OAuth information (ClientId
and ClientSecret
) from your newly-created application onto the Node's Connection, and you now have a working HubSpot CRM connector.
Below are detailed instructions to set this up. If you run into any issues with this process, please reach out to our support. Additionally, view the following HubSpot documentation for assistance: Create a developer app.
- If you already have an existing HubSpot Developer account, skip to Step 2.
- If you already have an existing HubSpot Public Application, skip to Step 2.4.
1. Create a HubSpot Developer Account
- Go to the HubSpot Developer Portal and create a Developer Account.
- Follow the on-screen prompts, insert any required information, and finish set up.
2. Create a HubSpot Public Application
- Sign in at the HubSpot Developer Portal.
- Navigate to Apps → Create app.
- Fill in the required details of your application as desired, and click Create app.
- On your application's dashboard, click the Auth tab to find your
Client ID
andClient Secret
. Copy these, as you will need it for later steps. - Under the Redirect URLs section, add the following:
- Under the Scopes section, click Add new scope. Add the following:
- oauth (Required)
- All
crm.*
scopes that match your application's needs (e.g.crm.objects.contacts.read
, etc.) (Conditionally-Required)
- Save your newly-created HubSpot Public Application.
3. Create the Connection
- In the Flowgear Console, click Connections.
- Add a new
Connection
of type HubSpot CRM. - Paste the
Client ID
andClient Secret
from your HubSpot application from Step 2. - Click Connect your Account.
- You will be redirected to a HubSpot login page using its authorisation URL. Sign in and grant the application access by using one of your developer test accounts.
- Save your
Connection
.
After you authorise the application, HubSpot will redirect you back to Flowgear with an authorisation code. The platform automatically completes the OAuth 2.0 handshake by exchanging the code for an
Access Token
andRefresh Token
, which are securely stored within the Connection.
4. Test your Connection
- Navigate to your new HubSpot CRM Connection.
- Click Test.
- Flowgear will attempt a test API call to a generic HubSpot endpoint to ensure your credentials are valid.
Available Samples and Services
This Node uses a built-in Postman collection to provide structured samples for CRM API endpoints.
The supported services currently include:
- Contacts
- Companies
- Deals
- Tickets
- Engagements
- Associations
- Custom Objects
When you select a sample, Flowgear sets up everything - method, endpoint, headers, body, and any required parameters.
Remarks
This Node no longer supports API key authentication. If you were using an API key previously, you must migrate to a public developer app in HubSpot. See HubSpot's documentation for guidance: Create a developer app. If you still have workflows that relied on an old API key, clone the scopes into a public application, reconnect in Flowgear, and your existing workflows should continue to run, with no edits needed.
AccessToken
is refreshed automatically when it expires. If a refresh fails, you’ll be prompted to reconnect your account.