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

# HubSpot integration

[Back to list of enterprise systems](https://koreai.mintlify.site/agent-platform/integrations/enterprise-systems.md)

Use the HubSpot integration to manage CRM records, lists, workflows, associations, subscriptions, files, and website content through Action Tools. HubSpot also provides triggers for CRM changes, form submissions, email activity, and other events.

| Authentication | Actions | Triggers |
| - | - | - |
| OAuth 2.0 | ([45](#supported-actions)) | ([24](#triggers)) |

## Supported actions

| Action | Use it to |
| - | - |
| [Add contact To List](#add-contact-to-list) | Add contact to list |
| [Add Contact to Workflow](#add-contact-to-workflow) | Adds a contact to a specified workflow in your HubSpot account. |
| [Create Associations](#create-associations) | Creates associations between objects |
| [Create Company](#create-company) | Creates a company in Hubspot. |
| [Create Contact](#create-contact) | Creates a contact in Hubspot. |
| [Create COS Blog Post](#create-cos-blog-post) | Creates a blog post in you Hubspot COS blog. |
| [Create Custom Object](#create-custom-object) | Creates a custom object in Hubspot. |
| [Create Deal](#create-deal) | Creates a new deal in Hubspot. |
| [Create Line Item](#create-line-item) | Creates a line item in Hubspot. |
| [Create Page](#create-page) | Creates a new landing/site page. |
| [Create or Update Contact](#create-or-update-contact) | Creates a new contact or updates an existing contact based on email address. |
| [Create Product](#create-product) | Creates a product in Hubspot. |
| [Create Ticket](#create-ticket) | Creates a ticket in HubSpot. |
| [Get Company](#get-company) | Gets a company. |
| [Get Contact](#get-contact) | Gets a contact. |
| [Get Custom Object](#get-custom-object) | Gets a custom object. |
| [Get Deal](#get-deal) | Gets a deal. |
| [Get Line Item](#get-line-item) | Gets a line item. |
| [Get Product](#get-product) | Gets a product. |
| [Get Page](#get-page) | Gets landing/site page Details. |
| [Get Ticket](#get-ticket) | Gets a ticket. |
| [Delete Page](#delete-page) | Deletes an existing landing/site page. |
| [Remove Associations](#remove-associations) | Removes associations between objects |
| [Remove Contact from List](#remove-contact-from-list) | Remove a contact from a specific list. |
| [Remove Email Subscription](#remove-email-subscription) | Removes email subscription. |
| [Update Company](#update-company) | Updates a company in Hubspot. |
| [Update Contact](#update-contact) | Updates a contact in Hubspot. |
| [Update Custom Object](#update-custom-object) | Updates a custom object in Hubspot. |
| [Update Deal](#update-deal) | Updates a deal in HubSpot. |
| [Update Line Item](#update-line-item) | Updates a line item in Hubspot. |
| [Update Product](#update-product) | Updates a product in Hubspot. |
| [Update Ticket](#update-ticket) | Updates a ticket in HubSpot. |
| [Upload File](#upload-file) | Uploads a file to HubSpot File Manager. |
| [Find Associations](#find-associations) | Finds associations between objects |
| [Find Company](#find-company) | Finds a company by searching. |
| [Find Contact](#find-contact) | Finds a contact by searching. |
| [Find Custom Object](#find-custom-object) | Finds a custom object by searching. |
| [Find Deal](#find-deal) | Finds a deal by searching. |
| [Find Line Item](#find-line-item) | Finds a line item by searching. |
| [Find Product](#find-product) | Finds a product by searching. |
| [Find Ticket](#find-ticket) | Finds a ticket by searching. |
| [Get Owner by Email](#get-owner-by-email) | Gets an existing owner by email. |
| [Get Owner by ID](#get-owner-by-id) | Gets an existing owner by ID. |
| [Get Pipeline Stage Details](#get-pipeline-stage-details) | Finds and retrieves CRM object pipeline stage details. |
| [Custom API Call](#custom-api-call) | Make a custom API call to a specific endpoint |

## Triggers

| Trigger | Fires when |
| - | - |
| [Company Recently Created or Updated](#company-recently-created-or-updated) | Triggers when a company recently created or updated. |
| [Contact Recently Created or Updated](#contact-recently-created-or-updated) | Triggers when a contact recently created or updated. |
| [New Deal Property Change](#new-deal-property-change) | Triggers when a specified property is updated on a deal. |
| [New Email Subscriptions Timeline](#new-email-subscriptions-timeline) | Triggers when a new email timeline subscription added for the portal. |
| [Line Item Recently Created or Updated](#line-item-recently-created-or-updated) | Triggers when a line item recently created or updated. |
| [New Company](#new-company) | Trigger when a new company is added. |
| [New Company Property Change](#new-company-property-change) | Triggers when a specified property is updated on a company. |
| [New Contact](#new-contact) | Trigger when new contact is available. |
| [New Contact in List](#new-contact-in-list) | Triggers when a new contact is added to the specified list. |
| [New Contact Property Change](#new-contact-property-change) | Triggers when a specified property is updated on a contact. |
| [New COS Blog Article](#new-cos-blog-article) | Triggers when a new article is added to your COS blog. |
| [New Custom Object](#new-custom-object) | Triggers when new custom object is available. |
| [New Custom Object Property Change](#new-custom-object-property-change) | Triggers when a specified property is updated on a custom object. |
| [New Deal](#new-deal) | Trigger when a new deal is added. |
| [New Email Event](#new-email-event) | Triggers when all,or specific new email event is available. |
| [New Engagement](#new-engagement) | Triggers when a new engagement is created. |
| [New Form Submission](#new-form-submission) | Triggers when a form is submitted. |
| [New Line Item](#new-line-item) | Triggers when new line item is available. |
| [New Product](#new-product) | Triggers when new product is available. |
| [New Ticket](#new-ticket) | Trigger when new ticket is available. |
| [New Ticket Property Change](#new-ticket-property-change) | Triggers when a specified property is updated on a ticket. |
| [Product Recently Created or Updated](#product-recently-created-or-updated) | Triggers when a product recently created or updated. |
| [New Task](#new-task) | Trigger when a new task is added. |
| [Updated Deal Stage](#updated-deal-stage) | Triggers when a deal enters a specified stage. |

## Prerequisites

* A HubSpot account with access to the CRM objects, lists, workflows, files, or content used by your tools.
* Permission to authorize the HubSpot OAuth access requested by the integration profile.

## Set up the integration

**1. Connect HubSpot**

In **Integrations**, select **HubSpot** > **Connect**. Create an **Integration Profile** for HubSpot, complete the OAuth 2.0 setup, and authorize the account your tools will use. Use the scopes and redirect URI shown in the profile setup.

**2. Create an action tool**

In **Tools**, select **New Tool** > **Action** > **HubSpot** > **Continue**. Select the action and auth profile, configure its inputs, and create the tool. Then [assign the tool to an agent](https://koreai.mintlify.site/agent-platform/tools/actions.md#assign-an-action-to-an-agent).

## Action reference

The connector catalog lists the required parameter names below. Studio may also show optional inputs for an action; review the selected action's input panel when configuring a tool.

> [accordion] Add contact To List
>
> Add contact to list
>
> **Required parameters:** `listId`, `email`

> [accordion] Add Contact to Workflow
>
> Adds a contact to a specified workflow in your HubSpot account.
>
> **Required parameters:** `workflowId`, `email`

> [accordion] Create Associations
>
> Creates associations between objects
>
> **Required parameters:** `fromObjectId`, `fromObjectType`, `toObjectType`, `associationType`, `toObjectIds`

> [accordion] Create Company
>
> Creates a company in Hubspot.
>
> **Required parameters:** None listed in the connector catalog.

> [accordion] Create Contact
>
> Creates a contact in Hubspot.
>
> **Required parameters:** None listed in the connector catalog.

> [accordion] Create COS Blog Post
>
> Creates a blog post in you Hubspot COS blog.
>
> **Required parameters:** `contentGroupId`, `authorId`, `status`, `slug`, `title`, `body`, `meta`, `imageUrl`

> [accordion] Create Custom Object
>
> Creates a custom object in Hubspot.
>
> **Required parameters:** `customObjectType`

> [accordion] Create Deal
>
> Creates a new deal in Hubspot.
>
> **Required parameters:** `dealname`, `pipelineId`, `pipelineStageId`

> [accordion] Create Line Item
>
> Creates a line item in Hubspot.
>
> **Required parameters:** `productId`

> [accordion] Create Page
>
> Creates a new landing/site page.
>
> **Required parameters:** `pageType`, `pageTitle`, `internalPageName`, `templatePath`, `slug`

> [accordion] Create or Update Contact
>
> Creates a new contact or updates an existing contact based on email address.
>
> **Required parameters:** `email`

> [accordion] Create Product
>
> Creates a product in Hubspot.
>
> **Required parameters:** None listed in the connector catalog.

> [accordion] Create Ticket
>
> Creates a ticket in HubSpot.
>
> **Required parameters:** `ticketName`, `pipelineId`, `pipelineStageId`

> [accordion] Get Company
>
> Gets a company.
>
> **Required parameters:** `companyId`

> [accordion] Get Contact
>
> Gets a contact.
>
> **Required parameters:** `contactId`

> [accordion] Get Custom Object
>
> Gets a custom object.
>
> **Required parameters:** `customObjectType`, `customObjectId`

> [accordion] Get Deal
>
> Gets a deal.
>
> **Required parameters:** `dealId`

> [accordion] Get Line Item
>
> Gets a line item.
>
> **Required parameters:** `lineItemId`

> [accordion] Get Product
>
> Gets a product.
>
> **Required parameters:** `productId`

> [accordion] Get Page
>
> Gets landing/site page Details.
>
> **Required parameters:** `pageType`, `pageId`

> [accordion] Get Ticket
>
> Gets a ticket.
>
> **Required parameters:** `ticketId`

> [accordion] Delete Page
>
> Deletes an existing landing/site page.
>
> **Required parameters:** `pageType`, `pageId`

> [accordion] Remove Associations
>
> Removes associations between objects
>
> **Required parameters:** `fromObjectId`, `fromObjectType`, `toObjectType`, `associationType`, `toObjectIds`

> [accordion] Remove Contact from List
>
> Remove a contact from a specific list.
>
> **Required parameters:** `listId`, `email`

> [accordion] Remove Email Subscription
>
> Removes email subscription.
>
> **Required parameters:** `email`

> [accordion] Update Company
>
> Updates a company in Hubspot.
>
> **Required parameters:** `companyId`

> [accordion] Update Contact
>
> Updates a contact in Hubspot.
>
> **Required parameters:** `contactId`

> [accordion] Update Custom Object
>
> Updates a custom object in Hubspot.
>
> **Required parameters:** `customObjectType`, `customObjectId`

> [accordion] Update Deal
>
> Updates a deal in HubSpot.
>
> **Required parameters:** `dealId`

> [accordion] Update Line Item
>
> Updates a line item in Hubspot.
>
> **Required parameters:** `lineItemId`

> [accordion] Update Product
>
> Updates a product in Hubspot.
>
> **Required parameters:** `productId`

> [accordion] Update Ticket
>
> Updates a ticket in HubSpot.
>
> **Required parameters:** `ticketId`

> [accordion] Upload File
>
> Uploads a file to HubSpot File Manager.
>
> **Required parameters:** `folderId`, `fileName`, `accessLevel`, `file`

> [accordion] Find Associations
>
> Finds associations between objects
>
> **Required parameters:** `fromObjectId`, `fromObjectType`, `toObjectType`

> [accordion] Find Company
>
> Finds a company by searching.
>
> **Required parameters:** `firstSearchPropertyName`, `firstSearchPropertyValue`

> [accordion] Find Contact
>
> Finds a contact by searching.
>
> **Required parameters:** `firstSearchPropertyName`, `firstSearchPropertyValue`

> [accordion] Find Custom Object
>
> Finds a custom object by searching.
>
> **Required parameters:** `customObjectType`, `firstSearchPropertyName`, `firstSearchPropertyValue`

> [accordion] Find Deal
>
> Finds a deal by searching.
>
> **Required parameters:** `firstSearchPropertyName`, `firstSearchPropertyValue`

> [accordion] Find Line Item
>
> Finds a line item by searching.
>
> **Required parameters:** `firstSearchPropertyName`, `firstSearchPropertyValue`

> [accordion] Find Product
>
> Finds a product by searching.
>
> **Required parameters:** `firstSearchPropertyName`, `firstSearchPropertyValue`

> [accordion] Find Ticket
>
> Finds a ticket by searching.
>
> **Required parameters:** `firstSearchPropertyName`, `firstSearchPropertyValue`

> [accordion] Get Owner by Email
>
> Gets an existing owner by email.
>
> **Required parameters:** `email`

> [accordion] Get Owner by ID
>
> Gets an existing owner by ID.
>
> **Required parameters:** `ownerId`

> [accordion] Get Pipeline Stage Details
>
> Finds and retrieves CRM object pipeline stage details.
>
> **Required parameters:** `objectType`, `pipelineId`, `stageId`

> [accordion] Custom API Call
>
> Make a custom API call to a specific endpoint
>
> **Required parameters:** `url`, `method`, `headers`, `queryParams`

## Trigger reference

The trigger inputs and required status below follow the connector catalog. Dropdown choices depend on the HubSpot account and selected object or pipeline.

> [accordion] Company Recently Created or Updated
>
> | Parameter | Type | Required | Description |
> | - | - | - | - |
> | `markdown` | string | No | ### Properties to retrieve: |
>
> name, domain, industry, about\_us, phone, address, address2, city, state, zip, country, website, type, description, founded\_year, hs\_createdate, hs\_lastmodifieddate, hs\_object\_id, is\_public, timezone, total\_money\_raised, total\_revenue, owneremail, ownername, numberofemployees, annualrevenue, lifecyclestage, createdate, web\_technologies
>
> **Specify here a list of additional properties to retrieve** |
> \| `additionalPropertiesToRetrieve` | multi-select dropdown | No | Additional properties to retrieve |

> [accordion] Contact Recently Created or Updated
>
> | Parameter | Type | Required | Description |
> | - | - | - | - |
> | `markdown` | string | No | ### Properties to retrieve: |
>
> firstname, lastname, email, company, website, mobilephone, phone, fax, address, city, state, zip, salutation, country, jobtitle, hs\_createdate, hs\_email\_domain, hs\_object\_id, lastmodifieddate, hs\_persona, hs\_language, lifecyclestage, createdate, numemployees, annualrevenue, industry
>
> **Specify here a list of additional properties to retrieve** |
> \| `additionalPropertiesToRetrieve` | multi-select dropdown | No | Additional properties to retrieve |

> [accordion] New Deal Property Change
>
> | Parameter | Type | Required | Description |
> | - | - | - | - |
> | `propertyName` | dropdown | Yes | Property Name |

> [accordion] New Email Subscriptions Timeline
>
> | Parameter | Type | Required | Description |
> | - | - | - | - |
> | — | — | — | No configurable parameters listed. |

> [accordion] Line Item Recently Created or Updated
>
> | Parameter | Type | Required | Description |
> | - | - | - | - |
> | `markdown` | string | No | ### Properties to retrieve: |
>
> name, description, price, quantity, amount, discount, tax, createdate, hs\_object\_id, hs\_product\_id, hs\_images, hs\_lastmodifieddate, hs\_line\_item\_currency\_code, hs\_sku, hs\_url, hs\_cost\_of\_goods\_sold, hs\_discount\_percentage, hs\_term\_in\_months
>
> **Specify here a list of additional properties to retrieve** |
> \| `additionalPropertiesToRetrieve` | multi-select dropdown | No | Additional properties to retrieve |

> [accordion] New Company
>
> | Parameter | Type | Required | Description |
> | - | - | - | - |
> | `markdown` | string | No | ### Properties to retrieve: |
>
> name, domain, industry, about\_us, phone, address, address2, city, state, zip, country, website, type, description, founded\_year, hs\_createdate, hs\_lastmodifieddate, hs\_object\_id, is\_public, timezone, total\_money\_raised, total\_revenue, owneremail, ownername, numberofemployees, annualrevenue, lifecyclestage, createdate, web\_technologies
>
> **Specify here a list of additional properties to retrieve** |
> \| `additionalPropertiesToRetrieve` | multi-select dropdown | No | Additional properties to retrieve |

> [accordion] New Company Property Change
>
> | Parameter | Type | Required | Description |
> | - | - | - | - |
> | `propertyName` | dropdown | Yes | Property Name |

> [accordion] New Contact
>
> | Parameter | Type | Required | Description |
> | - | - | - | - |
> | `markdown` | string | No | ### Properties to retrieve: |
>
> firstname, lastname, email, company, website, mobilephone, phone, fax, address, city, state, zip, salutation, country, jobtitle, hs\_createdate, hs\_email\_domain, hs\_object\_id, lastmodifieddate, hs\_persona, hs\_language, lifecyclestage, createdate, numemployees, annualrevenue, industry
>
> **Specify here a list of additional properties to retrieve** |
> \| `additionalPropertiesToRetrieve` | multi-select dropdown | No | Additional properties to retrieve |

> [accordion] New Contact in List
>
> | Parameter | Type | Required | Description |
> | - | - | - | - |
> | `listId` | dropdown | Yes | Contact List |
> | `markdown` | string | No | ### Properties to retrieve: |
>
> firstname, lastname, email, company, website, mobilephone, phone, fax, address, city, state, zip, salutation, country, jobtitle, hs\_createdate, hs\_email\_domain, hs\_object\_id, lastmodifieddate, hs\_persona, hs\_language, lifecyclestage, createdate, numemployees, annualrevenue, industry
>
> **Specify here a list of additional properties to retrieve** |
> \| `additionalPropertiesToRetrieve` | multi-select dropdown | No | Additional properties to retrieve |

> [accordion] New Contact Property Change
>
> | Parameter | Type | Required | Description |
> | - | - | - | - |
> | `propertyName` | dropdown | Yes | Property Name |

> [accordion] New COS Blog Article
>
> | Parameter | Type | Required | Description |
> | - | - | - | - |
> | `articleState` | dropdown | Yes | Article State |

> [accordion] New Custom Object
>
> | Parameter | Type | Required | Description |
> | - | - | - | - |
> | `customObjectType` | dropdown | Yes | Type of Custom Object |
> | `markdown` | string | No | ### Properties to retrieve: |
>
> hs\_object\_id, hs\_lastmodifieddate, hs\_createdate
>
> **Specify here a list of additional properties to retrieve** |
> \| `additionalPropertiesToRetrieve` | dynamic property selector | No | Additional Properties to Retrieve |

> [accordion] New Custom Object Property Change
>
> | Parameter | Type | Required | Description |
> | - | - | - | - |
> | `customObjectType` | dropdown | Yes | Type of Custom Object |
> | `propertyName` | dynamic property selector | Yes | Property Name |

> [accordion] New Deal
>
> | Parameter | Type | Required | Description |
> | - | - | - | - |
> | `markdown` | string | No | ### Properties to retrieve: |
>
> dealtype, dealname, amount, description, closedate, createdate, num\_associated\_contacts, hs\_forecast\_amount, hs\_forecast\_probability, hs\_manual\_forecast\_category, hs\_next\_step, hs\_object\_id, hs\_lastmodifieddate, hubspot\_owner\_id, hubspot\_team\_id
>
> **Specify here a list of additional properties to retrieve** |
> \| `additionalPropertiesToRetrieve` | multi-select dropdown | No | Additional properties to retrieve |

> [accordion] New Email Event
>
> | Parameter | Type | Required | Description |
> | - | - | - | - |
> | `eventType` | dropdown | No | Event Type |

> [accordion] New Engagement
>
> | Parameter | Type | Required | Description |
> | - | - | - | - |
> | `eventType` | dropdown | No | Type |

> [accordion] New Form Submission
>
> | Parameter | Type | Required | Description |
> | - | - | - | - |
> | `formId` | dropdown | Yes | Form |
> | `allowMultipleFiles` | boolean | Yes | Return all file fields as array |

> [accordion] New Line Item
>
> | Parameter | Type | Required | Description |
> | - | - | - | - |
> | `markdown` | string | No | ### Properties to retrieve: |
>
> name, description, price, quantity, amount, discount, tax, createdate, hs\_object\_id, hs\_product\_id, hs\_images, hs\_lastmodifieddate, hs\_line\_item\_currency\_code, hs\_sku, hs\_url, hs\_cost\_of\_goods\_sold, hs\_discount\_percentage, hs\_term\_in\_months
>
> **Specify here a list of additional properties to retrieve** |
> \| `additionalPropertiesToRetrieve` | multi-select dropdown | No | Additional properties to retrieve |

> [accordion] New Product
>
> | Parameter | Type | Required | Description |
> | - | - | - | - |
> | `markdown` | string | No | ### Properties to retrieve: |
>
> createdate, description, name, price, tax, hs\_lastmodifieddate
>
> **Specify here a list of additional properties to retrieve** |
> \| `additionalPropertiesToRetrieve` | multi-select dropdown | No | Additional properties to retrieve |

> [accordion] New Ticket
>
> | Parameter | Type | Required | Description |
> | - | - | - | - |
> | `markdown` | string | No | ### Properties to retrieve: |
>
> subject, content, source\_type, createdate, hs\_pipeline, hs\_pipeline\_stage, hs\_resolution, hs\_ticket\_category, hs\_ticket\_id, hs\_ticket\_priority, hs\_lastmodifieddate, hubspot\_owner\_id, hubspot\_team\_id
>
> **Specify here a list of additional properties to retrieve** |
> \| `additionalPropertiesToRetrieve` | multi-select dropdown | No | Additional properties to retrieve |

> [accordion] New Ticket Property Change
>
> | Parameter | Type | Required | Description |
> | - | - | - | - |
> | `propertyName` | dropdown | Yes | Property Name |

> [accordion] Product Recently Created or Updated
>
> | Parameter | Type | Required | Description |
> | - | - | - | - |
> | `markdown` | string | No | ### Properties to retrieve: |
>
> createdate, description, name, price, tax, hs\_lastmodifieddate
>
> **Specify here a list of additional properties to retrieve** |
> \| `additionalPropertiesToRetrieve` | multi-select dropdown | No | Additional properties to retrieve |

> [accordion] New Task
>
> | Parameter | Type | Required | Description |
> | - | - | - | - |
> | `markdown` | string | No | ### Properties to retrieve: |
>
> hs\_task\_subject, hs\_task\_type, hs\_task\_priority, hubspot\_owner\_id, hs\_timestamp, hs\_queue\_membership\_ids, hs\_lastmodifieddate,hs\_createdate
>
> **Specify here a list of additional properties to retrieve** |
> \| `additionalPropertiesToRetrieve` | multi-select dropdown | No | Additional properties to retrieve |

> [accordion] Updated Deal Stage
>
> | Parameter | Type | Required | Description |
> | - | - | - | - |
> | `pipelineId` | dropdown | Yes | Deal Pipeline |
> | `stageId` | dropdown | Yes | Deal Stage |
> | `markdown` | string | No | ### Properties to retrieve: |
>
> dealtype, dealname, amount, description, closedate, createdate, num\_associated\_contacts, hs\_forecast\_amount, hs\_forecast\_probability, hs\_manual\_forecast\_category, hs\_next\_step, hs\_object\_id, hs\_lastmodifieddate, hubspot\_owner\_id, hubspot\_team\_id, hs\_v2\_date\_entered\_current\_stage
>
> **Specify here a list of additional properties to retrieve** |
> \| `additionalPropertiesToRetrieve` | multi-select dropdown | No | Additional properties to retrieve |

## Troubleshoot common issues

| Issue | Resolution |
| - | - |
| OAuth authorization fails | Confirm the profile's redirect URI and requested scopes are configured for the HubSpot OAuth app, then authorize the correct HubSpot account. |
| A CRM action or trigger can't find a record or property | Verify the record ID, object type, and the authorized account's access. For property-change triggers, select a property available for that object. |
| A list, workflow, form, or pipeline is missing | Confirm it exists in the authorized HubSpot account and that the profile grants the access required by the integration. |
| A tool can't upload or retrieve a file | Check the file inputs and confirm the HubSpot account and profile can access File Manager. |

## Related articles

* [Auth profiles](https://koreai.mintlify.site/agent-platform/administration/integrations-settings.md#auth-profiles)
* [Action Tools](https://koreai.mintlify.site/agent-platform/tools/actions.md)
* [HubSpot developer documentation](https://developers.hubspot.com/docs)


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