Umbraco DXP
CMSCloudHeartcoreMarketplace
  • Umbraco DXP
  • Sustainability Best Practices
  • Commercial products
    • Umbraco Forms
    • Umbraco Deploy
    • Umbraco Workflow
    • Umbraco Commerce
    • Umbraco UI Builder
    • Umbraco Engage
    • Commercial Products, Relations and dependencies
  • Marketplace
    • Introduction
    • Listing Your Package
    • Package Telemetry Data
  • Packages
    • Authorized Services
    • Storage Providers
  • Integrations
    • Categories
    • ActiveCampaign
    • ActiveCampaign with Umbraco Forms
    • Algolia
    • Aprimo
    • CookieBot
    • CommerceTools
    • Dynamics
    • emerchantpay with Umbraco Forms
    • Google Search Console
    • HubSpot
    • HubSpot with Umbraco Forms
    • inriver
    • Semrush
    • Shopify
    • Zapier
    • Zapier with Umbraco Forms
Powered by GitBook
On this page
  • Package Links
  • Minimum version requirements
  • Authentication
  • Working with the integration

Was this helpful?

Edit on GitHub
Export as PDF
  1. Integrations

HubSpot with Umbraco Forms

Details an integration available for Hubspot with Umbraco Forms, built and maintained by Umbraco HQ.

PreviousHubSpotNextinriver

Last updated 2 months ago

Was this helpful?

This integration provides a custom workflow for Umbraco Forms. The workflow settings allow form entries to be mapped to a HubSpot contact record. When the form is submitted, the details are stored within the Customer Relationship Management (CRM) platform.

Package Links

Minimum version requirements

To ensure compatibility, check the Dependencies tab on NuGet for the required Umbraco CMS version. For example, see .

Authentication

The package supports authentication using the OAuth protocol.

The first time the workflow is used, the installation needs to be authorized. That can be done by following these steps:

  1. Click the prompted link which will redirect to the HubSpot authentication page for the Umbraco Forms HubSpot app.

  2. Log into the HubSpot account and agree to the permissions that the app requires.

    • Permission is required in order to be able to read and write contact information.

After agreeing to the permissions a redirect happens to a website hosted at https://hubspot-forms-auth.umbraco.com.

  1. Copy the authorization code issued by HubSpot.

  2. Paste it into the field indicated within the Umbraco Forms installation.

Behind the scenes, this will make a request to HubSpot which will return two tokens - an access and a refresh token. The former will be provided in further API calls to HubSpot to authenticate the request. The latter will be stored via Umbraco's key/value service and will be used to retrieve a new access token when it expires.

A button is available to clear the authentication with HubSpot. Following this, the authentication process needs to be repeated before the integration can be used again.

When the OAuth authentication method is being used, the API call to retrieve the token is proxied via an endpoint on the same website. This allows the Umbraco Forms HubSpot app secret key to remain a secret.

Working with the integration

Follow the steps outlined below to start working with the integration:

  1. Add the "Save Contact to Hubspot" workflow to a form.

  2. Configure the mappings between the form and Hubspot fields.

When a form is submitted on the website, the workflow will execute and create a new contact record in your Hubspot account. It will be populated using the information mapped from the fields in the form submission.

NuGet install
Source code
Umbraco marketplace listing
Umbraco.Forms.Integrations.Crm.Hubspot
Select the HubSpot workflow
Defining mappings
Hubspot contacts