HubSpot CRM
Learn about the HubSpot CRM connector and how to use it on the Digibee Integration Platform.
The HubSpot CRM connector gives your pipelines direct access to HubSpot's CRM, the central database that stores your business relationships and processes.
Use this connector to automate workflows involving:
Contacts and companies: Create, update, search, batch-process, and merge records.
Tickets: Manage support and service tickets.
Engagements: Log and retrieve calls, emails, meetings, notes, and tasks associated with any record.
Associations: Create and manage relationships between records using the Associations API v3.
Properties and owners: Read and write standard and custom properties; retrieve owner assignments.
Pipelines: Inspect and manage deal and ticket pipeline stages.
Schemas and custom objects: Define and interact with custom object types.
Lists and imports: Manage static and active lists and import records in bulk.
The HubSpot CRM connector covers only the core CRM endpoints. For sales features such as deals and quotes, use the HubSpot Sales connector. For content management features such as pages and blogs, use the HubSpot CMS connector.
Parameters
The tables below describe all configuration parameters. Fields that support Double Braces expressions are marked in the Supports DB column.
Account
The account used by the connector. Supported types: OAuth Bearer, OAuth 2, and Secret Key. See Account types below for configuration details.
Account
❌
N/A
Fail on error
When enabled, pipeline execution stops on error. When disabled, execution continues and the result will show false for the success property.
Boolean
❌
False
Host
The base URL of the HubSpot API.
String
✅
N/A
Path
The specific HubSpot CRM endpoint to be accessed. The selected path determines the available operations and required settings. See the HubSpot CRM API reference for details on each endpoint.
String
❌
N/A
Method
The HTTP method used in the request.
String
❌
N/A
Connect timeout (ms)
Maximum time allowed to establish the connection, in milliseconds.
Integer
❌
30000
Read timeout (ms)
Maximum time allowed to read data, in milliseconds.
Integer
❌
30000
Stop on client error
When enabled, stops pipeline execution if an HTTP 4xx error occurs.
Boolean
❌
False
Stop on server error
When enabled, stops pipeline execution if an HTTP 5xx error occurs.
Boolean
❌
False
Override response charset
When enabled, replaces the charset returned by the endpoint with the value defined in Response charset. When disabled, the charset from the Content-Type header is used.
Boolean
❌
True
Response charset
Defines the charset to use when Override response charset is enabled.
String
❌
UTF-8
Documentation
Section for documenting relevant information about the connector configuration and business rules.
String
❌
N/A
Account types
The HubSpot CRM connector supports three account types. Choose the one that matches how your HubSpot app is configured. Learn more about how to configure each account type in the Accounts documentation.
OAuth Bearer
Use when you have a static OAuth access token from a HubSpot private app. See the HubSpot private apps guide for more details.
OAuth 2
Use when your HubSpot app follows the standard OAuth 2.0 authorization code flow. See the HubSpot OAuth 2.0 guide for more details.
Secret Key
Legacy option for integrations that use a HubSpot developer API key (hapikey). When this type is selected, the connector automatically injects the developer_hapikey header into every request.
HubSpot has deprecated developer API keys in favor of private app tokens and OAuth. Use the Secret Key account type only for legacy integrations that cannot be migrated. For new integrations, use OAuth Bearer.
Available paths
The connector exposes 52 paths organized by CRM resources. The table below lists the resource groups and the available operations for each one.
Contacts
Create, read, update, delete, search, batch create, batch read, batch update, batch delete, merge
Companies
Create, read, update, delete, search, batch create, batch read, batch update, batch delete, merge
Tickets
Create, read, update, delete, search, batch create, batch read, batch update, batch delete
Custom objects
Create, read, update, delete, search, batch create, batch read, batch update, batch delete
Engagements: Calls
Create, read, update, delete, batch read, batch update
Engagements: Emails
Create, read, update, delete, batch read, batch update
Engagements: Meetings
Create, read, update, delete, batch read, batch update
Engagements: Notes
Create, read, update, delete, batch read, batch update
Engagements: Tasks
Create, read, update, delete, batch read, batch update
Associations v3
Create, read, and delete associations between any two object types
Properties
Read and write standard and custom properties for any object
Owners
List and retrieve owner records
Pipelines
List and inspect deal and ticket pipeline stages
Schemas
List, create, and update custom object schemas
Lists
Create, read, update, delete, and manage member associations in static and active lists
Imports
Create and retrieve bulk import jobs
To find the objectTypeId required by some paths (for example, when working with custom objects or properties), send a GET request to /crm/v3/schemas. See the HubSpot object type IDs reference for the full list of standard object IDs.
Last updated
Was this helpful?