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.

Configuring the Node

1. Create a HubSpot Application

If you already have an existing HubSpot application, skip to Step 1.4.

1. Sign in at the HubSpot Developer Portal.
2. Navigate to Apps → Create app.
3. Fill in the required details of your application as desired, and click Create app.
4. On your application's dashboard, click the Auth tab to find your Client ID and Client Secret. You will need these for later steps.
5. Under the Redirect URLs section, add the following:
   • https://app.flowgear.net/r/auth
   • https://appnew.flowgear.net/r/auth
   • https://appnext.flowgear.net/r/auth
6. 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)

2. Create the Connection

1. In the Flowgear Console, click Connections.
2. Add a new Connection of type HubSpot CRM.
3. Enter the Client ID and Client Secret from your HubSpot application from Step 1.
4. Click Connect your Account.
5. You will be redirected to a HubSpot login page using its authorisation URL. Sign in and grant the application access.
6. 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 and Refresh Token, which are securely stored within the Connection.

3. Test your Connection

1. Navigate to your new HubSpot CRM Connection.
2. Click Test.
3. 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

• AccessToken is refreshed automatically when it expires. If a refresh fails, you’ll be prompted to reconnect your account.