> Markdown versions of all pages of this connector library are available by appending `.md` to the page URL. For the full index of connectors, see [llms.txt](https://connectors.appmixer.com/llms.txt).

# HubSpot connector

- Connector: `appmixer.hubspot`
- Version: 4.9.5
- Components: 40 (8 triggers, 32 actions)

HubSpot is a developer and marketer of software products for inbound marketing and sales.

- Connector page: <https://connectors.appmixer.com/connector/appmixer.hubspot/4.9.5>
- Documentation: <https://docs.appmixer.com/connector-configuration/hubspot>
- Source code: <https://github.com/clientIO/appmixer-connectors/tree/dev/src/appmixer/hubspot>
- Download package: <https://connectors.appmixer.com/connector/appmixer.hubspot/4.9.5/download>

## Authentication

**Type:** OAuth 2

This connector is globally authenticated and verified by Appmixer (Authentication Hub) and is ready to use without registering your own OAuth application with the provider. You can still use your own OAuth credentials (clientId and clientSecret) - see the Connector Configuration section of the documentation. The Authentication Hub is enabled for all hosted Appmixer tenants; on self-managed installations it has to be explicitly set.

**Auth URL:** <https://app.hubspot.com/oauth/authorize>

**Scopes:**

- `oauth`
- `tickets`
- `automation`
- `e-commerce`
- `forms`
- `timeline`
- `media_bridge.read`
- `crm.lists.read`
- `crm.lists.write`
- `crm.objects.companies.write`
- `crm.objects.companies.read`
- `crm.objects.contacts.read`
- `crm.objects.contacts.write`
- `crm.objects.deals.read`
- `crm.objects.deals.write`
- `crm.objects.owners.read`
- `crm.schemas.companies.read`
- `crm.schemas.companies.write`
- `crm.schemas.contacts.read`
- `crm.schemas.contacts.write`
- `crm.schemas.custom.read`
- `crm.schemas.deals.read`
- `crm.schemas.deals.write`
- `sales-email-read`

## Triggers (8)

- [Contact Property Changed](https://connectors.appmixer.com/connector/appmixer.hubspot/4.9.5/component/appmixer.hubspot.crm.ContactPropertyChanged.md) (`appmixer.hubspot.crm.ContactPropertyChanged`): Triggers when a specific contact property changes value.
- [Deleted Contact](https://connectors.appmixer.com/connector/appmixer.hubspot/4.9.5/component/appmixer.hubspot.crm.DeletedContact.md) (`appmixer.hubspot.crm.DeletedContact`): Triggers when a contact is deleted
- [Form Submission](https://connectors.appmixer.com/connector/appmixer.hubspot/4.9.5/component/appmixer.hubspot.crm.FormSubmission.md) (`appmixer.hubspot.crm.FormSubmission`): Triggers when a form is submitted in HubSpot.
- [New Contact](https://connectors.appmixer.com/connector/appmixer.hubspot/4.9.5/component/appmixer.hubspot.crm.NewContact.md) (`appmixer.hubspot.crm.NewContact`): Triggers when a new contact is created.
- [New Contact In List](https://connectors.appmixer.com/connector/appmixer.hubspot/4.9.5/component/appmixer.hubspot.crm.NewContactInList.md) (`appmixer.hubspot.crm.NewContactInList`): Triggers when a new contact is added to a specific HubSpot list.
- [New Deal](https://connectors.appmixer.com/connector/appmixer.hubspot/4.9.5/component/appmixer.hubspot.crm.NewDeal.md) (`appmixer.hubspot.crm.NewDeal`): Triggers when a new deal is created.
- [Updated Contact](https://connectors.appmixer.com/connector/appmixer.hubspot/4.9.5/component/appmixer.hubspot.crm.UpdatedContact.md) (`appmixer.hubspot.crm.UpdatedContact`): Triggers when a contact is modified
- [Updated Deal](https://connectors.appmixer.com/connector/appmixer.hubspot/4.9.5/component/appmixer.hubspot.crm.UpdatedDeal.md) (`appmixer.hubspot.crm.UpdatedDeal`): Triggers when a deal is modified

## Actions (32)

- [Make Api Call](https://connectors.appmixer.com/connector/appmixer.hubspot/4.9.5/component/appmixer.hubspot.core.MakeApiCall.md) (`appmixer.hubspot.core.MakeApiCall`): Performs an arbitrary authorized API call to the HubSpot API.
- [Add Company To List](https://connectors.appmixer.com/connector/appmixer.hubspot/4.9.5/component/appmixer.hubspot.crm.AddCompanyToList.md) (`appmixer.hubspot.crm.AddCompanyToList`): Add one or more companies to a HubSpot static list.
- [Add Contact To List](https://connectors.appmixer.com/connector/appmixer.hubspot/4.9.5/component/appmixer.hubspot.crm.AddContactToList.md) (`appmixer.hubspot.crm.AddContactToList`): Add one or more contacts to a HubSpot static (MANUAL) list.
- [Create Contact](https://connectors.appmixer.com/connector/appmixer.hubspot/4.9.5/component/appmixer.hubspot.crm.CreateContact.md) (`appmixer.hubspot.crm.CreateContact`): Create a new contact.
- [Create Line Item](https://connectors.appmixer.com/connector/appmixer.hubspot/4.9.5/component/appmixer.hubspot.crm.CreateLineItem.md) (`appmixer.hubspot.crm.CreateLineItem`): Create a new line item.
- [Delete Company](https://connectors.appmixer.com/connector/appmixer.hubspot/4.9.5/component/appmixer.hubspot.crm.DeleteCompany.md) (`appmixer.hubspot.crm.DeleteCompany`): Delete a company.
- [Delete Contact](https://connectors.appmixer.com/connector/appmixer.hubspot/4.9.5/component/appmixer.hubspot.crm.DeleteContact.md) (`appmixer.hubspot.crm.DeleteContact`): Delete a contact.
- [Delete Deal](https://connectors.appmixer.com/connector/appmixer.hubspot/4.9.5/component/appmixer.hubspot.crm.DeleteDeal.md) (`appmixer.hubspot.crm.DeleteDeal`): Delete a deal.
- [Enroll Contact In Workflow](https://connectors.appmixer.com/connector/appmixer.hubspot/4.9.5/component/appmixer.hubspot.crm.EnrollContactInWorkflow.md) (`appmixer.hubspot.crm.EnrollContactInWorkflow`): Enroll a contact in a HubSpot workflow by email. Requires a HubSpot subscription with workflows (Professional/Enterprise or a developer test account) — on free portals the workflows API rejects the call with 403 regardless of granted OAuth scopes.
- [Find Companies](https://connectors.appmixer.com/connector/appmixer.hubspot/4.9.5/component/appmixer.hubspot.crm.FindCompanies.md) (`appmixer.hubspot.crm.FindCompanies`): Find companies in HubSpot.
- [Find Contacts](https://connectors.appmixer.com/connector/appmixer.hubspot/4.9.5/component/appmixer.hubspot.crm.FindContacts.md) (`appmixer.hubspot.crm.FindContacts`): Find contacts.
- [Get Contact](https://connectors.appmixer.com/connector/appmixer.hubspot/4.9.5/component/appmixer.hubspot.crm.GetContact.md) (`appmixer.hubspot.crm.GetContact`): Get a contact by Email or ID.
- [Get Deal](https://connectors.appmixer.com/connector/appmixer.hubspot/4.9.5/component/appmixer.hubspot.crm.GetDeal.md) (`appmixer.hubspot.crm.GetDeal`): Get a deal by ID.
- [List Contacts](https://connectors.appmixer.com/connector/appmixer.hubspot/4.9.5/component/appmixer.hubspot.crm.ListContacts.md) (`appmixer.hubspot.crm.ListContacts`): List contacts.
- [List Deals](https://connectors.appmixer.com/connector/appmixer.hubspot/4.9.5/component/appmixer.hubspot.crm.ListDeals.md) (`appmixer.hubspot.crm.ListDeals`): List and filter deals.
- [List Owners](https://connectors.appmixer.com/connector/appmixer.hubspot/4.9.5/component/appmixer.hubspot.crm.ListOwners.md) (`appmixer.hubspot.crm.ListOwners`): List owners.
- [List Pipeline Stages](https://connectors.appmixer.com/connector/appmixer.hubspot/4.9.5/component/appmixer.hubspot.crm.ListPipelineStages.md) (`appmixer.hubspot.crm.ListPipelineStages`): List pipeline stages.
- [List Pipelines](https://connectors.appmixer.com/connector/appmixer.hubspot/4.9.5/component/appmixer.hubspot.crm.ListPipelines.md) (`appmixer.hubspot.crm.ListPipelines`): List pipelines.
- [List Products](https://connectors.appmixer.com/connector/appmixer.hubspot/4.9.5/component/appmixer.hubspot.crm.ListProducts.md) (`appmixer.hubspot.crm.ListProducts`): List products.
- [Remove Contact From List](https://connectors.appmixer.com/connector/appmixer.hubspot/4.9.5/component/appmixer.hubspot.crm.RemoveContactFromList.md) (`appmixer.hubspot.crm.RemoveContactFromList`): Remove one or more contacts from a HubSpot static (MANUAL) list.
- [Update Company](https://connectors.appmixer.com/connector/appmixer.hubspot/4.9.5/component/appmixer.hubspot.crm.UpdateCompany.md) (`appmixer.hubspot.crm.UpdateCompany`): Update an existing company in HubSpot. Supports merge strategy to only update empty fields.
- [Update Contact](https://connectors.appmixer.com/connector/appmixer.hubspot/4.9.5/component/appmixer.hubspot.crm.UpdateContact.md) (`appmixer.hubspot.crm.UpdateContact`): Update a contact.
- [Update Deal](https://connectors.appmixer.com/connector/appmixer.hubspot/4.9.5/component/appmixer.hubspot.crm.UpdateDeal.md) (`appmixer.hubspot.crm.UpdateDeal`): Update a deal.
- [Engagements - CreateEmail](https://connectors.appmixer.com/connector/appmixer.hubspot/4.9.5/component/appmixer.hubspot.engagements.CreateEmail.md) (`appmixer.hubspot.engagements.CreateEmail`): Create a email with the given properties and return a copy of the object, including the ID.
- [Create Note](https://connectors.appmixer.com/connector/appmixer.hubspot/4.9.5/component/appmixer.hubspot.engagements.CreateNote.md) (`appmixer.hubspot.engagements.CreateNote`): Create a Note associated with a specific contact, company, deal, ticket, or other supported object.
- [Create Task](https://connectors.appmixer.com/connector/appmixer.hubspot/4.9.5/component/appmixer.hubspot.engagements.CreateTask.md) (`appmixer.hubspot.engagements.CreateTask`): Create a Task associated with a specific contact, company, deal, ticket, or other supported object.
- [Delete Note](https://connectors.appmixer.com/connector/appmixer.hubspot/4.9.5/component/appmixer.hubspot.engagements.DeleteNote.md) (`appmixer.hubspot.engagements.DeleteNote`): Delete Note.
- [Find Notes](https://connectors.appmixer.com/connector/appmixer.hubspot/4.9.5/component/appmixer.hubspot.engagements.FindNotes.md) (`appmixer.hubspot.engagements.FindNotes`): Find Notes within HubSpot's CRM. Retrieves first 200 notes that match the search criteria.
- [Engagements - GetEmails](https://connectors.appmixer.com/connector/appmixer.hubspot/4.9.5/component/appmixer.hubspot.engagements.GetEmails.md) (`appmixer.hubspot.engagements.GetEmails`): Read a batch of emails by internal ID, or unique property values.
- [Update Note](https://connectors.appmixer.com/connector/appmixer.hubspot/4.9.5/component/appmixer.hubspot.engagements.UpdateNote.md) (`appmixer.hubspot.engagements.UpdateNote`): Update Note associated with a specific contact, company, deal, ticket, or other supported object.
- [Create Deal](https://connectors.appmixer.com/connector/appmixer.hubspot/4.9.5/component/appmixer.hubspot.crm.CreateDeal.md) (`appmixer.hubspot.crm.CreateDeal`): Create a new deal.
- [Create Company](https://connectors.appmixer.com/connector/appmixer.hubspot/4.9.5/component/appmixer.hubspot.crm.CreateCompany.md) (`appmixer.hubspot.crm.CreateCompany`): Create a new company in HubSpot CRM.

## Changelog

### 4.9.5

- Quote CSV cells that hold a comma, a double quote or a line break and map cells by header column when exporting results to a file.

### 4.9.4

- Security: API calls go through the engine's HTTP client (context.httpRequest). The connector no longer ships its own vulnerable axios, nor the unused request, request-promise and bluebird packages, and has no npm dependencies left.

### 4.9.3

- Security: webhook trigger listeners are now bound to the HubSpot portal of the connected account. Triggers send their access token with the listener registration; the plugin (AuthHub) resolves the token's portal and rejects a registration whose event name names another portal. The token is removed before the listener is stored. Registrations without a token (older connector versions) are still accepted with a warning until the connector setting `requireListenerAccessToken` is set to true. The AuthHub no longer stores the tenant's apiKey/appId in the listener.
- Webhook triggers now listen to the portal of the access token they use, not the portal stored in the account's profile on its first connection. An account keeps one token per consent and each consent can pick a different portal, so such triggers received no events.

### 4.9.2

- MakeApiCall: Request Headers and Query Parameters set in the Designer are now sent. They were silently dropped: the key-value field stores its rows as a JSON object string, which the component did not parse.

### 4.9.1

- Security: the webhook route (/plugins/appmixer/hubspot/events) now verifies the X-HubSpot-Signature-v3 header with the app's client secret (connector setting `clientSecret`) and rejects unsigned, forged or older than 5 minutes requests with 401. Requires `clientSecret` in the connector configuration of the instance (and of the AuthHub) that receives the webhooks.

### 4.9.0

- Fixed re-activation of disabled webhook subscriptions: the v3 API reports and takes `active`, not `enabled`, so a switched-off subscription was never turned back on (e.g. UpdatedDeal received nothing) and every existing one was PATCHed on each trigger start.
- Fixed two NewContact / NewDeal / UpdatedContact / UpdatedDeal flows of the same portal consuming each other's events (the dedupe cache key was shared across flows).
- ContactPropertyChanged: no longer misses a change of the watched property that was not the last change of the contact in a webhook batch (the events now carry every changed property name).
- Fixed the default deal owner subscription and the owner field showing up twice in the CreateDeal/UpdateDeal additional properties dropdown (hubspot_owner_id instead of the input name hubSpotOwnerId).
- Fixed a ReferenceError hiding the HubSpot error message when a webhook subscription API call failed.
- Components with a dynamic output port now export their item contract (ITEM_SCHEMA), so offline validation and `appmixer connector verify` can check it; the designer output is unchanged.
- CreateNote: the output now also contains associationTypeId (the create response carries no associations).
- NewContact, NewDeal, UpdatedContact, UpdatedDeal: test() throws explicitly when no example record exists.

### 4.8.1

- Fixed a crash when a Find/List component saved an EMPTY result set to a CSV file — the header row was built from the first record without checking there was one, so a search that legitimately matched nothing failed the flow instead of writing an empty file.

### 4.8.0

- Added ContactPropertyChanged trigger: fires when a specific contact property changes value.
- Added NewContactInList trigger: polls for new contacts added to a specific HubSpot list.
- Added FormSubmission trigger: polls for new submissions of a specific HubSpot form.
- Updated routes.js to dynamically create HubSpot webhook subscriptions for custom properties used in ContactPropertyChanged.
- Added the 'forms' OAuth scope, required by the FormSubmission trigger's submissions API.
- Added AddContactToList and RemoveContactFromList components and a list selection dropdown (ListLists source) for NewContactInList.
- Added CreateTask component for creating tasks (engagements of type TASK) associated with HubSpot objects.
- Added EnrollContactInWorkflow component for enrolling a contact in a HubSpot workflow by email, with a ListWorkflows helper source.
- Added the 'automation' OAuth scope required by the workflows API.
- FormSubmission: fixed the submissions endpoint path (form-integrations/v1/submissions/forms, the by-form variant returns 404).
- Added required-input validation (CancelError) across create/update/delete/find components.
- Added output port examples across crm and engagements components.
- Contact variable pickers (dynamic contact outPorts) now show types and example values.
- FormSubmission: the form is now selected from a dropdown (ListForms source) instead of a raw GUID input.
- Dynamic dropdowns (workflow, form, list, pipeline, deal stage, owner, product, contact property) switched from select to text typeahead so values can also be entered manually when the source is unavailable.
- NOT BREAKING despite the new OAuth scopes ('forms', 'automation'): they are configured as conditionally required on the HubSpot app, so existing connections and older connector deployments keep working; new consents request them and HubSpot grants them on any tier (feature gating happens at API-call time, not at consent). Deployment prerequisite: whitelabel apps must add both scopes to their HubSpot app config BEFORE rolling out this version, otherwise new consents fail on an unconfigured scope.

### 4.7.0

- Added MakeApiCall component for performing arbitrary authorized API calls to the HubSpot API.

### 4.6.0

- Added test() (Flow Test Mode) to the NewContact, UpdatedContact, NewDeal, UpdatedDeal and DeletedContact triggers.

### 4.5.1

- Added output examples to component schemas.

### 4.5.0

- Fixed UpdatedContact and UpdatedDeal triggers not firing for property changes outside the default watched list (e.g. lifecyclestage and custom properties). All propertyChange events now pass through to listeners; deduplication against creation events is handled internally.
- Fixed triggerListenersDelayed dropping the entire payload when any single object in a batch matched a creation event — now filters per-objectId.

### 4.4.1

- Added optional Pipeline and Stage filters to UpdatedDeal trigger.
- Added optional Pipeline filter to NewDeal trigger.
- Added Pipeline and Stage filter inputs to ListDeals action using CRM Search API filterGroups.
- Replaced hard-coded deal stages in UpdateDeal action with dynamic ListPipelineStages cascade.

### 4.3.1

- Reduced icon size for better performance.

### 4.3.0

- Added CreateCompany component for creating new companies.
- Added UpdateCompany component with smart merge strategy to only update empty fields.
- Added SearchCompany component for finding companies by domain.
- Added AddCompanyToList component for adding companies to static lists.
- Added GetCompaniesProperties component for dynamic property selection.
- All company components support `additionalProperties` for custom and third-party (e.g. Clearbit) fields.

### 4.2.3

- Fixed an issue with triggers not working when using AuthHub. Added additional check of webhook configuration.
- Fixed an issue with triggers not registering for inactive subscriptions.

### 4.2.1

- Added support for Notes: added components `Create Note`, `Delete Note`, `Find Notes` and `Update Note`.

### 4.1.3

- Fixed an issue when the `CreateDeal` component was showing error `resource not found`.
- Added custom properties and additional properties to the following components: `CreateContact`, `CreateDeal`, `UpdateContact` and `UpdateDeal`. Custom properties are new properties that are not part of the default HubSpot properties. Additional properties default HubSpot properties but were not part of the default properties list before.
- Added caching of Contact and Deal properties, which can be further configured in the connector settings.
- Improved listing output variables for `GetContact` to make it consistent with the selected properties in the input.

### 4.0.5

- Removed webhook subscribing when using AuthHub.
- Fixed an issue when HubSpot webhook was not automatically created when using own API key.

### 4.0.4

- Added `properties` input to triggers NewContact, UpdatedContact, NewDeal, UpdatedDeal.
- Fixed an issue when the `DeletedContact` trigger was not starting.

### 4.0.2

- (breaking change) Improve webhook handling by better event distribution using events/listeners (applies to Appmixer version 6+). Affected components: NewContact, UpdatedContact, NewDeal, UpdatedDeal.

### 3.0.1

- (breaking change) Improve webhook handling by better event distribution. Affected components: NewContact, UpdatedContact, NewDeal, UpdatedDeal.

### 2.2.0

- New component: Engagements - GetEmails: Read a batch of emails by internal ID, or unique property values.
- Update component: GetContact: fix support for adding properties, add support for retrieving associations.

### 2.0.1

- (breaking change) ListContacts: fix the output to match the Contact Properties scheme, standardize output to 'All at once', 'One at a time', 'File'.
- (breaking change) ListContacts: remove the 'search' input.
- Added new component `FindContacts` to search for contacts by email address.
- ListContacts: add 'properties' input to select which properties to return.
- GetContact: add 'properties' input to select which properties to return.

### 1.2.0

- Add ListPipelineStages
- Fix ListPipelines
- Fix CreateDeal

### 1.1.3

- Fix webhook subscriptions. Now current webhooks in Hubspot are used to determine whether a subscription should be created.

### 1.1.2

- Fix UpdatedDeal

### 1.1.1

- NewDeal ignores webhooks for deleted deals.

### 1.1.0

- Added stage and pipeline select inputs for CreateDeal and UpdateDeal

### 1.0.4

- Fix scope list
- Fix contact updated webhooks triggering for every individual property

### 1.0.3

- NewContact ignores contacts deleted in the meantime.

### 1.0.2

- Authorization scope changed because of a Hubspot scope change.

### 1.0.0

- Initial version
