Skip to content
Documentation
Contact
← Back to documentation
Technical Reference

HubSpot

Synchronize contacts, companies, deals, tickets and marketing data across workflows.

CategoryCRM
AuthenticationOAuth 2.0, custom
Version0.11.0
Published scopes29 published scopes
Last updatedSeptember 19, 2026

Overview

Connect HubSpot with Flows360

Synchronize contacts, companies, deals, tickets and marketing data across workflows.

Use the HubSpot connector to include its declared actions and events in Flows360 workflows without duplicating the integration logic inside each consuming system. This pinned connector version currently exposes 54 actions and 24 triggers.

Available actions

  • Add contact To List
  • Add Contact to Workflow
  • Create Associations
  • Create Company
  • Create Contact
  • Create COS Blog Post
  • Create Custom Object
  • Create Deal
  • Plus 46 additional declared actions.

Available triggers

  • Company Recently Created or Updated
  • Contact Recently Created or Updated
  • New Deal Property Change
  • New Email Subscriptions Timeline
  • Line Item Recently Created or Updated
  • New Company
  • Plus 18 additional declared triggers.

The capability list above is generated from the exact reviewed connector package so the public description stays aligned with the version Flows360 operates.

Technical guide

Technical reference

Package identity

  • Connector: HubSpot
  • Package: @activepieces/piece-hubspot@0.11.0
  • Exact artifact digest: sha256:9f25a56e83d9118963683d107eb42e23217aaf37eae0541425eb0cf2cb811587
  • Runtime: Activepieces-compatible deterministic worker
  • Source: the exact reviewed Activepieces source

Authentication

OAUTH2, CUSTOM AUTH. Connection values are tenant-specific and remain in the consuming Studio instance; CDK stores definitions and field metadata, not customer credential values.

Action contracts

  • Add contact To List (add_contact_to_list), Add contact to list Classification: read.
  • Add Contact to Workflow (add-contact-to-workflow), Adds a contact to a specified workflow in your HubSpot account. Classification: read.
  • Create Associations (create-associations), Creates associations between objects Classification: read.
  • Create Company (create-company), Creates a company in Hubspot. Classification: read.
  • Create Contact (create-contact), Creates a contact in Hubspot. Classification: read.
  • Create COS Blog Post (create-blog-post), Creates a blog post in you Hubspot COS blog. Classification: read.
  • Create Custom Object (create-custome-object), Creates a custom object in Hubspot. Classification: read.
  • Create Deal (create-deal), Creates a new deal in Hubspot. Classification: read.
  • Create Line Item (create-line-item), Creates a line item in Hubspot. Classification: read.
  • Create Page (create-page), Creates a new landing/site page. Classification: read.
  • Create or Update Contact (create-or-update-contact), Creates a new contact or updates an existing contact based on email address. Classification: read.
  • Create Product (create-product), Creates a product in Hubspot. Classification: read.
  • Create Ticket (create-ticket), Creates a ticket in HubSpot. Classification: read.
  • Get Company (get-company), Gets a company. Classification: read.
  • Get Contact (get-contact), Gets a contact. Classification: read.
  • Get Custom Object (get-custom-object), Gets a custom object. Classification: read.
  • Get Deal (get-deal), Gets a deal. Classification: read.
  • Get Line Item (get-line-item), Gets a line item. Classification: read.
  • Get Product (get-product), Gets a product. Classification: read.
  • Get Page (get-page), Gets landing/site page Details. Classification: read.
  • Get Ticket (get-ticket), Gets a ticket. Classification: read.
  • Delete Page (delete-page), Deletes an existing landing/site page. Classification: read.
  • Remove Associations (remove-associations), Removes associations between objects Classification: read.
  • Remove Contact from List (remove-contact-from-list), Remove a contact from a specific list. Classification: read.
  • Remove Email Subscription (remove-email-subscription), Removes email subscription. Classification: read.
  • Update Company (update-company), Updates a company in Hubspot. Classification: read.
  • Update Contact (update-contact), Updates a contact in Hubspot. Classification: read.
  • Update Custom Object (update-custome-object), Updates a custom object in Hubspot. Classification: read.
  • Update Deal (update-deal), Updates a deal in HubSpot. Classification: read.
  • Update Line Item (update-line-item), Updates a line item in Hubspot. Classification: read.
  • Update Product (update-product), Updates a product in Hubspot. Classification: read.
  • Update Ticket (update-ticket), Updates a ticket in HubSpot. Classification: read.
  • Upload File (upload-file), Uploads a file to HubSpot File Manager. Classification: read.
  • Find Associations (find-associations), Finds associations between objects Classification: read.
  • Find Company (find-company), Finds a company by searching. Classification: read.
  • Find Contact (find-contact), Finds a contact by searching. Classification: read.
  • Find Custom Object (find-custom-object), Finds a custom object by searching. Classification: read.
  • Find Deal (find-deal), Finds a deal by searching. Classification: read.
  • Find Line Item (find-line-item), Finds a line item by searching. Classification: read.
  • Find Product (find-product), Finds a product by searching. Classification: read.
  • Find Ticket (find-ticket), Finds a ticket by searching. Classification: read.
  • Get Owner by Email (get-owner-by-email), Gets an existing owner by email. Classification: read.
  • List Pipelines (list_pipelines), Lists the pipelines defined for deals or tickets. Classification: read.
  • List Pipeline Stages (list_pipeline_stages), Lists the stages of one pipeline. Classification: read.
  • List Lists (list_static_lists), Lists the contact lists in the account. Classification: read.
  • List Association Types (list_association_types), Lists the association types available between two object types. Classification: read.
  • List Owners (list_owners), Lists the CRM owners in the account. Classification: read.
  • List Object Properties (list_object_properties), Lists the properties defined on a CRM object type. Classification: read.
  • Create Note (create_note), Logs a note on the timeline of a CRM record. Classification: read.
  • Create Task (create_task), Creates a task against a CRM record. Classification: read.
  • Search Objects (search_objects), Searches any CRM object type with full filter, sort and paging support. Classification: read.
  • Get Owner by ID (get-owner-by-id), Gets an existing owner by ID. Classification: read.
  • Get Pipeline Stage Details (get-pipeline-stage-details), Finds and retrieves CRM object pipeline stage details. Classification: read.
  • Custom API Call (custom_api_call), Make a custom API call to a specific endpoint Classification: read.

Trigger contracts

  • Company Recently Created or Updated, polling.
  • Contact Recently Created or Updated, polling.
  • New Deal Property Change, polling.
  • New Email Subscriptions Timeline, polling.
  • Line Item Recently Created or Updated, polling.
  • New Company, polling.
  • New Company Property Change, polling.
  • New Contact, polling.
  • New Contact in List, polling.
  • New Contact Property Change, polling.
  • New COS Blog Article, polling.
  • New Custom Object, polling.
  • New Custom Object Property Change, polling.
  • New Deal, polling.
  • New Email Event, polling.
  • New Engagement, polling.
  • New Form Submission, polling.
  • New Line Item, polling.
  • New Product, polling.
  • New Ticket, polling.
  • New Ticket Property Change, polling.
  • Product Recently Created or Updated, polling.
  • New Task, polling.
  • Updated Deal Stage, polling.

Verification

Deterministic execution evidence is recorded for the pinned artifact, including 1 exercised action entrypoint and 0 exercised trigger entrypoints.

Capability summary

AuthenticationOAuth 2.0, custom
Supported objects78
Supported actionsNot published
Triggers24

Authentication

Authentication method: OAuth 2.0, custom

Required scopes

crm.lists.readcrm.lists.writecrm.objects.companies.readcrm.objects.companies.writecrm.objects.contacts.readcrm.objects.contacts.writecrm.objects.custom.readcrm.objects.custom.writecrm.objects.deals.readcrm.objects.deals.writecrm.objects.line_items.readcrm.objects.owners.readcrm.objects.leads.readcrm.objects.leads.writecrm.schemas.companies.readcrm.schemas.contacts.readcrm.schemas.custom.readcrm.schemas.deals.readcrm.schemas.line_items.readautomatione-commerceticketscontentsettings.currencies.readsettings.users.readsettings.users.teams.readfilesformsscheduler.meetings.meeting-link.read

Authentication profiles

connection · oauth2

OAuth scopes: crm.lists.read, crm.lists.write, 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.line_items.read, crm.objects.owners.read, crm.objects.leads.read, crm.objects.leads.write, crm.schemas.companies.read, crm.schemas.contacts.read, crm.schemas.custom.read, crm.schemas.deals.read, crm.schemas.line_items.read, automation, e-commerce, tickets, content, settings.currencies.read, settings.users.read, settings.users.teams.read, files, forms, scheduler.meetings.meeting-link.read

connection_2 · custom
  • Private App Access Token Required · protected credential

Supported objects

ObjectReadWriteNotes
Add contact To List Yes No Add contact to list
Add Contact to Workflow Yes No Adds a contact to a specified workflow in your HubSpot account.
Create Associations Yes No Creates associations between objects
Create Company Yes No Creates a company in Hubspot.
Create Contact Yes No Creates a contact in Hubspot.
Create COS Blog Post Yes No Creates a blog post in you Hubspot COS blog.
Create Custom Object Yes No Creates a custom object in Hubspot.
Create Deal Yes No Creates a new deal in Hubspot.
Create Line Item Yes No Creates a line item in Hubspot.
Create Page Yes No Creates a new landing/site page.
Create or Update Contact Yes No Creates a new contact or updates an existing contact based on email address.
Create Product Yes No Creates a product in Hubspot.
Create Ticket Yes No Creates a ticket in HubSpot.
Get Company Yes No Gets a company.
Get Contact Yes No Gets a contact.
Get Custom Object Yes No Gets a custom object.
Get Deal Yes No Gets a deal.
Get Line Item Yes No Gets a line item.
Get Product Yes No Gets a product.
Get Page Yes No Gets landing/site page Details.
Get Ticket Yes No Gets a ticket.
Delete Page Yes No Deletes an existing landing/site page.
Remove Associations Yes No Removes associations between objects
Remove Contact from List Yes No Remove a contact from a specific list.
Remove Email Subscription Yes No Removes email subscription.
Update Company Yes No Updates a company in Hubspot.
Update Contact Yes No Updates a contact in Hubspot.
Update Custom Object Yes No Updates a custom object in Hubspot.
Update Deal Yes No Updates a deal in HubSpot.
Update Line Item Yes No Updates a line item in Hubspot.
Update Product Yes No Updates a product in Hubspot.
Update Ticket Yes No Updates a ticket in HubSpot.
Upload File Yes No Uploads a file to HubSpot File Manager.
Find Associations Yes No Finds associations between objects
Find Company Yes No Finds a company by searching.
Find Contact Yes No Finds a contact by searching.
Find Custom Object Yes No Finds a custom object by searching.
Find Deal Yes No Finds a deal by searching.
Find Line Item Yes No Finds a line item by searching.
Find Product Yes No Finds a product by searching.
Find Ticket Yes No Finds a ticket by searching.
Get Owner by Email Yes No Gets an existing owner by email.
List Pipelines Yes No Lists the pipelines defined for deals or tickets.
List Pipeline Stages Yes No Lists the stages of one pipeline.
List Lists Yes No Lists the contact lists in the account.
List Association Types Yes No Lists the association types available between two object types.
List Owners Yes No Lists the CRM owners in the account.
List Object Properties Yes No Lists the properties defined on a CRM object type.
Create Note Yes No Logs a note on the timeline of a CRM record.
Create Task Yes No Creates a task against a CRM record.
Search Objects Yes No Searches any CRM object type with full filter, sort and paging support.
Get Owner by ID Yes No Gets an existing owner by ID.
Get Pipeline Stage Details Yes No Finds and retrieves CRM object pipeline stage details.
Custom API Call Yes No Make a custom API call to a specific endpoint
Company Recently Created or Updated Yes No polling trigger declared by the pinned package.
Contact Recently Created or Updated Yes No polling trigger declared by the pinned package.
New Deal Property Change Yes No polling trigger declared by the pinned package.
New Email Subscriptions Timeline Yes No polling trigger declared by the pinned package.
Line Item Recently Created or Updated Yes No polling trigger declared by the pinned package.
New Company Yes No polling trigger declared by the pinned package.
New Company Property Change Yes No polling trigger declared by the pinned package.
New Contact Yes No polling trigger declared by the pinned package.
New Contact in List Yes No polling trigger declared by the pinned package.
New Contact Property Change Yes No polling trigger declared by the pinned package.
New COS Blog Article Yes No polling trigger declared by the pinned package.
New Custom Object Yes No polling trigger declared by the pinned package.
New Custom Object Property Change Yes No polling trigger declared by the pinned package.
New Deal Yes No polling trigger declared by the pinned package.
New Email Event Yes No polling trigger declared by the pinned package.
New Engagement Yes No polling trigger declared by the pinned package.
New Form Submission Yes No polling trigger declared by the pinned package.
New Line Item Yes No polling trigger declared by the pinned package.
New Product Yes No polling trigger declared by the pinned package.
New Ticket Yes No polling trigger declared by the pinned package.
New Ticket Property Change Yes No polling trigger declared by the pinned package.
Product Recently Created or Updated Yes No polling trigger declared by the pinned package.
New Task Yes No polling trigger declared by the pinned package.
Updated Deal Stage Yes No polling trigger declared by the pinned package.

Triggers

Company Recently Created or Updated · Poll

Triggers when a company recently created or updated.

Inputs

  • markdown · string
  • additionalPropertiesToRetrieve · array
Contact Recently Created or Updated · Poll

Triggers when a contact recently created or updated.

Inputs

  • markdown · string
  • additionalPropertiesToRetrieve · array
New Deal Property Change · Poll

Triggers when a specified property is updated on a deal.

Inputs

  • propertyName · string
New Email Subscriptions Timeline · Poll

Triggers when a new email timeline subscription added for the portal.

Line Item Recently Created or Updated · Poll

Triggers when a line item recently created or updated.

Inputs

  • markdown · string
  • additionalPropertiesToRetrieve · array
New Company · Poll

Trigger when a new company is added.

Inputs

  • markdown · string
  • additionalPropertiesToRetrieve · array
New Company Property Change · Poll

Triggers when a specified property is updated on a company.

Inputs

  • propertyName · string
New Contact · Poll

Trigger when new contact is available.

Inputs

  • markdown · string
  • additionalPropertiesToRetrieve · array
New Contact in List · Poll

Triggers when a new contact is added to the specified list.

Inputs

  • listId · string
  • markdown · string
  • additionalPropertiesToRetrieve · array
New Contact Property Change · Poll

Triggers when a specified property is updated on a contact.

Inputs

  • propertyName · string
New COS Blog Article · Poll

Triggers when a new article is added to your COS blog.

Inputs

  • articleState · string
New Custom Object · Poll

Triggers when new custom object is available.

Inputs

  • customObjectType · string
  • markdown · string
  • additionalPropertiesToRetrieve · object
New Custom Object Property Change · Poll

Triggers when a specified property is updated on a custom object.

Inputs

  • customObjectType · string
  • propertyName · object
New Deal · Poll

Trigger when a new deal is added.

Inputs

  • markdown · string
  • additionalPropertiesToRetrieve · array
New Email Event · Poll

Triggers when all,or specific new email event is available.

Inputs

  • eventType · string
New Engagement · Poll

Triggers when a new engagement is created.

Inputs

  • eventType · string
New Form Submission · Poll

Triggers when a form is submitted.

Inputs

  • formId · string
  • allowMultipleFiles · boolean
New Line Item · Poll

Triggers when new line item is available.

Inputs

  • markdown · string
  • additionalPropertiesToRetrieve · array
New Product · Poll

Triggers when new product is available.

Inputs

  • markdown · string
  • additionalPropertiesToRetrieve · array
New Ticket · Poll

Trigger when new ticket is available.

Inputs

  • markdown · string
  • additionalPropertiesToRetrieve · array
New Ticket Property Change · Poll

Triggers when a specified property is updated on a ticket.

Inputs

  • propertyName · string
Product Recently Created or Updated · Poll

Triggers when a product recently created or updated.

Inputs

  • markdown · string
  • additionalPropertiesToRetrieve · array
New Task · Poll

Trigger when a new task is added.

Inputs

  • markdown · string
  • additionalPropertiesToRetrieve · array
Updated Deal Stage · Poll

Triggers when a deal enters a specified stage.

Inputs

  • pipelineId · string
  • stageId · string
  • markdown · string
  • additionalPropertiesToRetrieve · array

Setup

Setup

  1. Add the HubSpot connector to the workflow in the target Flows360 Studio instance.
  2. Create or select the tenant-specific connection required by the connector. Connection secrets remain in the Studio connection boundary and are not copied into CDK documentation.
  3. Provide the connection fields declared by the pinned package:
  • Private App Access Token (access_token), required; stored as a sensitive connection value.

OAuth scopes

  • crm.lists.read
  • crm.lists.write
  • 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.line_items.read
  • crm.objects.owners.read
  • crm.objects.leads.read
  • crm.objects.leads.write
  • crm.schemas.companies.read
  • crm.schemas.contacts.read
  • crm.schemas.custom.read
  • crm.schemas.deals.read
  • crm.schemas.line_items.read
  • automation
  • e-commerce
  • tickets
  • content
  • settings.currencies.read
  • settings.users.read
  • settings.users.teams.read
  • files
  • forms
  • scheduler.meetings.meeting-link.read
  1. Select the required action or trigger and complete its declared input fields. Required and optional inputs are defined by the exact package schema.
  2. Test the workflow in the appropriate environment before enabling production scheduling or event delivery.

Limitations

Limitations and operational notes

  • This content describes @activepieces/piece-hubspot@0.11.0; provider behaviour can change independently and should be revalidated when the provider or connector version changes.
  • Only the 54 actions and 24 triggers declared by this pinned package are represented here.
  • Tenant credentials and connection values are not stored in the public connector record.
  • Provider-side permissions, account entitlements, quotas and rate limits remain subject to the connected provider account and are not inferred when the package does not declare them.
  • Deterministic execution evidence is recorded for the pinned artifact, including 1 exercised action entrypoint and 0 exercised trigger entrypoints.

Troubleshooting

Why canu2019t the connector authenticate?

Check the tenant connection in Studio and confirm every required HubSpot connection field is present. Re-authorise OAuth-based connections if the provider token or consent has expired. Do not place credential values in CDK content or logs.

Why is an action or trigger unavailable?

Confirm that the workflow is using @activepieces/piece-hubspot@0.11.0 and compare the requested capability with the declared action and trigger list for this version. A capability that is not declared by the pinned package should not be presented as supported.

What should I check after a provider-side change?

Revalidate authentication, required fields, action/trigger behaviour and provider documentation before publishing refreshed connector content or moving a new package version into production.

github.com