HubSpot integration – Appmixer connector library

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

Changelog

26 versions

v4.8.0 Latest

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.

v4.7.0

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

v4.6.0

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

v4.5.1

Added output examples to component schemas.

v4.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.

v4.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.

v4.3.1

Reduced icon size for better performance.

v4.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.

v4.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.

v4.2.1

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

v4.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.

v4.0.5

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

v4.0.4

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

v4.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.

v3.0.1

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

v2.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.

v2.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.

v1.2.0

Add ListPipelineStages
Fix ListPipelines
Fix CreateDeal

v1.1.3

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

v1.1.2

Fix UpdatedDeal

v1.1.1

NewDeal ignores webhooks for deleted deals.

v1.1.0

Added stage and pipeline select inputs for CreateDeal and UpdateDeal

v1.0.4

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

v1.0.3

NewContact ignores contacts deleted in the meantime.

v1.0.2

Authorization scope changed because of a Hubspot scope change.

v1.0.0

Initial version

Authentication

Type	Details
OAuth 2	Authentication Hub Verified This connector is globally authenticated and verified by Appmixer and is ready to use without registering your own OAuth application with the provider. Appmixer's Authentication Hub acts as an authentication proxy, so all OAuth-based connectors work out of the box. You can still use your own OAuth credentials (clientId and clientSecret) for enhanced customization or compliance — 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

Contact Property Changed

Triggers when a specific contact property changes value.

Form Submission

Triggers when a form is submitted in HubSpot.

New Contact In List

Triggers when a new contact is added to a specific HubSpot list.

Actions

Make Api Call

Performs an arbitrary authorized API call to the HubSpot API.

Add Company To List

Add one or more companies to a HubSpot static list.

Add Contact To List

Add one or more contacts to a HubSpot static (MANUAL) list.

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.