> ## Documentation Index
> Fetch the complete documentation index at: https://docs.stackone.com/llms.txt
> Use this file to discover all available pages before exploring further.

# HubSpot

> How to set up the HubSpot connector, plus the actions that are available.

![HubSpot](https://stackone-logos.com/api/hubspot/filled/svg)

v3.4.1[See changelog](https://docs.stackone.com/connectors/hubspot/changelog.md)

[95 actions](#actions) · 2 auth methods

CRM
IAM
Customer Support

## Getting Started

**1. Create or Select a Project**

Set up a new project or select an existing one. See [Organizations & Projects](https://docs.stackone.com/gateway/concepts/organizations-and-projects.md).

**2. Configure the Connector**

Enable the connector and create a Connector Profile in your project. See [Setup Connector Profile](https://docs.stackone.com/gateway/quickstart.md#setup-connector-profile).

> [card] [OAuth 2.0 · Connector Profile](https://docs.stackone.com/connectors/hubspot/guides/connector-profile/oauth-2-0.md)
>
> Requires a HubSpot app, either created with the HubSpot CLI or an existing legacy public app.

> [card] [Private App Access Token · Connector Profile](https://docs.stackone.com/connectors/hubspot/guides/connector-profile/private-app-access-token.md)
>
> Account-level access with a static token from a HubSpot Private App, not tied to any user's permissions or ownership.

**3. Link an Account**

Link an account [from the dashboard](https://docs.stackone.com/connect/managing-connectors/linking-accounts.md#link-from-the-dashboard) (or via [StackOne Hub](https://docs.stackone.com/embed/account-linking/overview)).

See the guide for the authentication type chosen in the Connector Profile:

> [card] [OAuth 2.0 · Link Account](https://docs.stackone.com/connectors/hubspot/guides/link-account/oauth-2-0.md)

> [card] [Private App Access Token · Link Account](https://docs.stackone.com/connectors/hubspot/guides/link-account/private-app-access-token.md)

**4. Use Actions**

Connect an AI platform to the linked account's actions. See [AI Platforms](https://docs.stackone.com/ai-platforms/overview.md).

Other ways to call actions are listed in [Protocols & SDKs](https://docs.stackone.com/connect/protocols-and-sdks.md).

## Actions

Authentication type

Select all
|
Clear

OAuth 2.0

Private App Access Token

No auth methods found

Scopes

Select all
|
Clear

content

crm.objects.companies.read

crm.objects.companies.write

crm.objects.contacts.read

crm.objects.contacts.write

crm.objects.custom.read

crm.objects.custom.write

crm.objects.deals.read

crm.objects.deals.write

crm.objects.leads.read

crm.objects.leads.write

crm.objects.line\_items.read

crm.objects.line\_items.write

crm.objects.owners.read

crm.objects.products.read

crm.objects.products.write

crm.objects.quotes.read

crm.objects.quotes.write

crm.objects.tickets.read

crm.objects.tickets.write

crm.objects.users.read

crm.schemas.custom.read

crm.schemas.custom.write

forms

marketing.campaigns.read

marketing.campaigns.write

oauth

sales-email-read

settings.users.read

settings.users.teams.read

tickets

No scopes found

95 actions

ActionDescriptionRequired scopes

Get Account Details`hubspot_get_account_details`

Retrieve account configuration details for the authenticated HubSpot account

`oauth`

List Associations`hubspot_list_associations`

Retrieve all associations for a specific CRM record with pagination

`crm.objects.contacts.read`

Create Association`hubspot_create_association`

Create a default unlabeled association between two CRM records

`crm.objects.contacts.write`

Delete Association`hubspot_delete_association`

Remove all associations between two CRM records

`crm.objects.contacts.write`

Batch Read Associations`hubspot_batch_read_associations`

Retrieve associations for multiple CRM records in a single request with pagination

`crm.objects.contacts.read`

Batch Create Associations`hubspot_batch_create_associations`

Create multiple labeled associations in a single request

`crm.objects.contacts.write`

List Contacts`hubspot_list_contacts`

Retrieve a paginated list of contacts from HubSpot CRM with filtering and property selection

`crm.objects.contacts.read`

Get Contact`hubspot_get_contact`

Retrieve a single contact by ID with optional property and association filtering

`crm.objects.contacts.read`

Create Contact`hubspot_create_contact`

Create a new contact in HubSpot CRM with specified properties

`crm.objects.contacts.write`

Update Contact`hubspot_update_contact`

Update an existing contact's properties in HubSpot CRM

`crm.objects.contacts.write`

Delete Contact`hubspot_delete_contact`

Delete a contact from HubSpot CRM by ID

`crm.objects.contacts.write`

Search Contacts`hubspot_search_contacts`

Search for contacts using filters, sorts, and queries in HubSpot CRM

`crm.objects.contacts.read`

Batch Create Contacts`hubspot_batch_create_contacts`

Create multiple contacts in a single request (max 100)

`crm.objects.contacts.write`

Batch Update Contacts`hubspot_batch_update_contacts`

Update multiple contacts in a single request (max 100)

`crm.objects.contacts.write`

List Companies`hubspot_list_companies`

Retrieve a paginated list of companies from HubSpot CRM with filtering and property selection

`crm.objects.companies.read`

Get Company`hubspot_get_company`

Retrieve a single company by ID with optional property and association filtering

`crm.objects.companies.read`

Create Company`hubspot_create_company`

Create a new company in HubSpot CRM with specified properties

`crm.objects.companies.write`

Update Company`hubspot_update_company`

Update an existing company's properties in HubSpot CRM

`crm.objects.companies.write`

Delete Company`hubspot_delete_company`

Delete a company from HubSpot CRM by ID

`crm.objects.companies.write`

Search Companies`hubspot_search_companies`

Search for companies using filters, sorts, and queries in HubSpot CRM

`crm.objects.companies.read`

Batch Create Companies`hubspot_batch_create_companies`

Create multiple companies in a single request (max 100)

`crm.objects.companies.write`

Batch Update Companies`hubspot_batch_update_companies`

Update multiple companies in a single request (max 100)

`crm.objects.companies.write`

List Deals`hubspot_list_deals`

Retrieve a paginated list of deals from HubSpot CRM with filtering and property selection

`crm.objects.deals.read`

Get Deal`hubspot_get_deal`

Retrieve a single deal by ID with optional property and association filtering

`crm.objects.deals.read`

Create Deal`hubspot_create_deal`

Create a new deal in HubSpot CRM with specified properties

`crm.objects.deals.write`

Update Deal`hubspot_update_deal`

Update an existing deal's properties in HubSpot CRM

`crm.objects.deals.write`

Delete Deal`hubspot_delete_deal`

Delete a deal from HubSpot CRM by ID

`crm.objects.deals.write`

Search Deals`hubspot_search_deals`

Search for deals using filters, sorts, and queries in HubSpot CRM

`crm.objects.deals.read`

Batch Create Deals`hubspot_batch_create_deals`

Create multiple deals in a single request (max 100)

`crm.objects.deals.write`

Batch Update Deals`hubspot_batch_update_deals`

Update multiple deals in a single request (max 100)

`crm.objects.deals.write`

List Deal Pipelines`hubspot_list_deal_pipelines`

Retrieve all deal pipelines from HubSpot

`crm.objects.deals.read`

Get Deal Pipeline`hubspot_get_deal_pipeline`

Retrieve a specific deal pipeline by ID from HubSpot

`crm.objects.deals.read`

Create Deal Pipeline`hubspot_create_deal_pipeline`

Create a new deal pipeline in HubSpot with its stages

`crm.objects.deals.write`

Update Deal Pipeline`hubspot_update_deal_pipeline`

Partially update a deal pipeline's top-level properties (label, displayOrder). Does not modify stages.

`crm.objects.deals.write`

List Deal Pipeline Stages`hubspot_list_deal_pipeline_stages`

Retrieve all stages for a specific deal pipeline from HubSpot

`crm.objects.deals.read`

Get Deal Pipeline Stage`hubspot_get_deal_pipeline_stage`

Retrieve a specific stage from a deal pipeline by ID

`crm.objects.deals.read`

Create Deal Pipeline Stage`hubspot_create_deal_pipeline_stage`

Add a new stage to an existing deal pipeline

`crm.objects.deals.write`

Update Deal Pipeline Stage`hubspot_update_deal_pipeline_stage`

Partially update a stage within a deal pipeline

`crm.objects.deals.write`

List Owners`hubspot_list_owners`

Retrieve all current owners in the HubSpot account

`crm.objects.owners.read`

Get Owner`hubspot_get_owner`

Retrieve detailed information about a specific owner by ID

`crm.objects.owners.read`

List CRM Objects`hubspot_list_crm_objects`

Retrieve a paginated list of CRM objects of any type from HubSpot

`crm.objects.contacts.read``crm.objects.companies.read``crm.objects.deals.read``crm.objects.custom.read``tickets``crm.objects.products.read``crm.objects.line_items.read``crm.objects.quotes.read``crm.objects.leads.read``crm.objects.tickets.read`

Get CRM Object`hubspot_get_crm_object`

Retrieve a single CRM object of any type by ID from HubSpot

`crm.objects.contacts.read``crm.objects.companies.read``crm.objects.deals.read``crm.objects.custom.read``tickets``crm.objects.products.read``crm.objects.line_items.read``crm.objects.quotes.read``crm.objects.leads.read``crm.objects.tickets.read`

Create CRM Object`hubspot_create_crm_object`

Create a new CRM object of any type in HubSpot with optional associations

`crm.objects.contacts.write``crm.objects.companies.write``crm.objects.deals.write``crm.objects.custom.write``tickets``crm.objects.products.write``crm.objects.line_items.write``crm.objects.quotes.write``crm.objects.leads.write``crm.objects.tickets.write`

Update CRM Object`hubspot_update_crm_object`

Update properties of an existing CRM object in HubSpot

`crm.objects.contacts.write``crm.objects.companies.write``crm.objects.deals.write``crm.objects.custom.write``tickets``crm.objects.products.write``crm.objects.line_items.write``crm.objects.quotes.write``crm.objects.leads.write``crm.objects.tickets.write`

Delete CRM Object`hubspot_delete_crm_object`

Delete a CRM object of any type from HubSpot by ID

`crm.objects.contacts.write``crm.objects.companies.write``crm.objects.deals.write``crm.objects.custom.write``tickets``crm.objects.products.write``crm.objects.line_items.write``crm.objects.quotes.write``crm.objects.leads.write``crm.objects.tickets.write`

List Logged Emails For Record`hubspot_list_logged_emails_for_record`

Retrieve the emails logged on a specific contact, company, deal or ticket, including subject and body

`sales-email-read`

List Logged Emails`hubspot_list_logged_emails`

Retrieve a paginated list of all sales emails logged in the HubSpot CRM

`sales-email-read`

Get Logged Email`hubspot_get_logged_email`

Retrieve a single logged sales email by ID, including subject, body and associated records

`sales-email-read`

Search Logged Emails`hubspot_search_logged_emails`

Search logged sales emails using filters, sorts and queries in HubSpot CRM

`sales-email-read`

Batch Read Logged Emails`hubspot_batch_read_logged_emails`

Retrieve up to 100 logged sales emails by ID in a single request

`sales-email-read`

Get Object Properties`hubspot_get_object_properties`

Retrieve all properties for a specific CRM object type to discover available fields

`crm.objects.contacts.read``crm.objects.companies.read``crm.objects.deals.read``crm.objects.custom.read``crm.schemas.custom.read``tickets``crm.objects.products.read``crm.objects.line_items.read``crm.objects.quotes.read``crm.objects.leads.read``crm.objects.tickets.read`

List Custom Object Schemas`hubspot_list_custom_object_schemas`

Retrieve all custom object schemas defined in your HubSpot account

`crm.schemas.custom.read`

Get Custom Object Schema`hubspot_get_custom_object_schema`

Retrieve a specific custom object schema by its object type or ID

`crm.schemas.custom.read`

Create Custom Object Schema`hubspot_create_custom_object_schema`

Create a new custom object schema in HubSpot

`crm.schemas.custom.write`

Create Custom Object Association`hubspot_create_custom_object_association`

Create a new association between a custom object and another object type

`crm.schemas.custom.write`

Update Custom Object Schema`hubspot_update_custom_object_schema`

Update an existing custom object schema

`crm.schemas.custom.write`

Delete Custom Object Schema`hubspot_delete_custom_object_schema`

Delete a custom object schema from HubSpot

`crm.schemas.custom.write`

Delete Custom Object Association`hubspot_delete_custom_object_association`

Remove an association definition from a custom object schema

`crm.schemas.custom.write`

Get Unified Credentials`hubspot_unified_get_me`

Get the current HubSpot connection's unified credentials and identity.

List Unified Groups`hubspot_unified_list_groups`

List unified groups (HubSpot teams) in the connected account.

`settings.users.teams.read`

Get Unified Group`hubspot_unified_get_group`

Get a unified HubSpot group (team) by id.

`settings.users.teams.read`

List Unified Organizations`hubspot_unified_list_organizations`

List unified organizations (the HubSpot portal) for the connection.

Get Unified Organization`hubspot_unified_get_organization`

Get a unified HubSpot organization (portal) by id.

List Unified Roles`hubspot_unified_list_roles`

List unified HubSpot roles (permission sets) in the connected account.

`settings.users.read`

Get Unified Role`hubspot_unified_get_role`

Get a unified HubSpot role (permission set) by id.

`settings.users.read`

List Unified Users`hubspot_unified_list_users`

List unified users in the connected HubSpot account.

`settings.users.read``crm.objects.owners.read``crm.objects.users.read`

Get Unified User`hubspot_unified_get_user`

Get a unified HubSpot user by id or email.

`settings.users.read``crm.objects.owners.read``crm.objects.users.read`

List Campaigns`hubspot_list_campaigns`

Search and retrieve marketing campaigns with filtering, sorting, and pagination

`marketing.campaigns.read`

Get Campaign`hubspot_get_campaign`

Retrieve a specific marketing campaign by ID with optional metrics

`marketing.campaigns.read`

Create Campaign`hubspot_create_campaign`

Create a new marketing campaign in HubSpot with custom properties

`marketing.campaigns.write`

Update Campaign`hubspot_update_campaign`

Perform a partial update of a marketing campaign in HubSpot

`marketing.campaigns.write`

Delete Campaign`hubspot_delete_campaign`

Delete a marketing campaign from HubSpot by campaign ID

`marketing.campaigns.write`

List Campaign Assets`hubspot_list_campaign_assets`

Retrieve assets associated with a marketing campaign by type with optional metrics

`marketing.campaigns.read`

Add Asset To Campaign`hubspot_add_campaign_asset`

Associate an asset with a marketing campaign

`marketing.campaigns.write`

Remove Asset From Campaign`hubspot_remove_campaign_asset`

Remove an asset's association with a marketing campaign

`marketing.campaigns.write`

List Marketing Emails`hubspot_list_marketing_emails`

Retrieve a paginated list of marketing emails from HubSpot with filtering options

`content`

Get Marketing Email`hubspot_get_marketing_email`

Retrieve a single marketing email by ID with optional property filtering

`content`

Create Marketing Email`hubspot_create_marketing_email`

Create a new marketing email in HubSpot with comprehensive configuration

`content`

Update Marketing Email`hubspot_update_marketing_email`

Update an existing marketing email in HubSpot with comprehensive configuration

`content`

Delete Marketing Email`hubspot_delete_marketing_email`

Delete a marketing email from HubSpot by ID

`content`

Clone Marketing Email`hubspot_clone_marketing_email`

Create a copy of an existing marketing email

`content`

Publish Marketing Email`hubspot_publish_marketing_email`

Publish a marketing email to make it available for sending

`content`

List Forms`hubspot_list_forms`

Retrieve all forms from HubSpot account with pagination

`forms`

Get Form`hubspot_get_form`

Retrieve a specific form by ID from HubSpot

`forms`

List Form Submissions`hubspot_list_form_submissions`

Retrieve submissions for a specific form to track marketing funnel conversions

`forms`

List Tickets`hubspot_list_tickets`

Retrieve a paginated list of all tickets from HubSpot

`tickets``crm.objects.tickets.read`

Get Ticket`hubspot_get_ticket`

Retrieve a specific ticket by ID from HubSpot

`tickets``crm.objects.tickets.read`

Create Ticket`hubspot_create_ticket`

Create a new ticket in HubSpot

`tickets``crm.objects.tickets.write`

Update Ticket`hubspot_update_ticket`

Update an existing ticket in HubSpot

`tickets``crm.objects.tickets.write`

Delete Ticket`hubspot_delete_ticket`

Move a ticket to the recycling bin

`tickets``crm.objects.tickets.write`

Search Tickets`hubspot_search_tickets`

Search for tickets using filters, sorts, and queries in HubSpot CRM

`tickets``crm.objects.tickets.read`

List Ticket Pipelines`hubspot_list_ticket_pipelines`

Retrieve all ticket pipelines from HubSpot

`tickets``crm.objects.tickets.read`

Get Ticket Pipeline`hubspot_get_ticket_pipeline`

Retrieve a specific ticket pipeline by ID from HubSpot

`tickets``crm.objects.tickets.read`

List Ticket Pipeline Stages`hubspot_list_ticket_pipeline_stages`

Retrieve all stages for a specific ticket pipeline from HubSpot

`tickets``crm.objects.tickets.read`

Get Ticket Pipeline Stage`hubspot_get_ticket_pipeline_stage`

Retrieve a specific stage from a ticket pipeline by ID

`tickets``crm.objects.tickets.read`


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.