For the complete documentation index, see llms.txt. This page is also available as Markdown.

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.

Parameter
Description
Type
Supports DB
Default

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

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.

Account type
When to use

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.

Resource
Available operations

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?