0 votes

HubSpot: Umbraco CMS Integration

A form picker and rendering component for HubSpot forms using two authentication methods: API Key and OAuth.

To use an API key, the following app setting will need to be added to `Web.config`:

<add key="Umbraco.Cms.Integrations.Crm.Hubspot.ApiKey" value="[your API key]" />

The key will be added to all requests made to the HubSpot API and used to authenticate access.

If you prefer not to use an API key, an authentication flow using OAuth is also available. To use this, simply ensure you don't have an API key in your configuration file.

To support multi-region HubSpot forms, the following app setting is needed in `Web.config`:

<add key="Umbraco.cms.Integrations.Crm.Hubspot.Region" value="[region]" />

For example, forms hosted in EU will use the `eu1` setting.

Backoffice usage

To use the form picker, a new data type should be created based on the HubSpot Form Picker property editor. 

Depending on the configuration, a message will be prompted. 

If OAuth is being used for authentication, then the Connect button will be enabled and trigger the authorization workflow. The access token will be saved into the database and used for future requests.

Revoke action will remove the access token from the database.

Front-end rendering

A strongly typed model will be generated by the property value converter and an HTML helper is available to easily render the form on the front-end.

Ensure your template has a reference to the following using statement:

@using Umbraco.Cms.Integrations.Hubspot.Helpers;

and render the form using (assuming a property based on the created type, with alias `hubspotForm` has been created):

@Html.RenderHubspotForm(Model.hubspotForm)

Changes
1.1.5 (November 22nd 2022)
  • Package icon

1.1.4 (November 4th 2022)
  • Marketplace updates and tags
  • Telemetry elements

1.1.3 (October 6th 2022)
  • Remove render view for Umbraco 8 in packages installed on Umbraco 9 and above
  • Property Editor namings

1.1.2 (August 10th 2022)
  • Login from property editor
1.0.2 (April 14th 2022)
  • Updated Client ID and scopes for the "HubSpot for Umbraco" marketplace app
1.0.1 (March 9th 2022)
  • Fixed HubSpot script path for EU region
1.0.0 (March 9th 2022)
  • Initial release

 

Screenshots

Package files

Archived files

Documentation

Source code

 Download package
version 1.1.5

NuGet install instructions for Umbraco 1.0.0-9+

Install-Package Umbraco.Cms.Integrations.Crm.Hubspot

NuGet install instructions for Umbraco 9+

dotnet add package Umbraco.Cms.Integrations.Crm.Hubspot

Package owner

Umbraco HQ

Umbraco HQ

Umbraco has 7882 karma points
hq

Package Compatibility

This package is compatible with the following versions as reported by community members who have downloaded this package:
Untested or doesn't work on Umbraco Cloud
Version 8.18.x (100%)

You must login before you can report on package compatibility.

Previously reported to work on versions: 8.5.x

Package Information

  • Package owner: Umbraco HQ
  • Created: 08/03/2022
  • Current version 1.1.5
  • .NET version 4.7.2
  • License MIT
  • Downloads on Our: 226
  • Downloads on NuGet: 15.2K
  • Total downloads : 15.4K