Submit a ticket

Getting started with HubSpot

Setting up the Oneflow integration is easy! Check out this article, and you will learn how to set up, activate, and use your HubSpot CRM integration with Oneflow.

Special notes:

Before getting started with the Oneflow integration, be sure to pay attention to the following:

  • Admins register users with the same email address they use in Oneflow and the associated HubSpot account.

  • You can only connect one Oneflow account to a specific HubSpot account. Subsequently, changing the Oneflow account connected to that HubSpot account will be impossible.

  • To activate the integration, you must have the Super Admin role in HubSpot.

  • When inviting a user as a HubSpot admin, add them as a Sales Professional if you want them to use the products.

  • When upgrading your account to Sales Professional, it will take some time before Oneflow has the correct scope of e-commerce.

  • Note that collections are now called workspaces.

Enable HubSpot integration in Oneflow


Before getting started, ensure you are signed in to your HubSpot and Oneflow accounts with the same email address.

  1. In Oneflow, go to Admin > Extensions, and enable the HubSpot extension.
  2. Click the HubSpot link to open the settings page > Authenticate to HubSpot. You will then be redirected to your HubSpot account.

  3. Select the HubSpot account you want to integrate with Oneflow and click Choose Account to authorize the integration:
    The integration is now active!

Create a HubSpot template in Oneflow

After configuring the integration, you need to activate the HubSpot template group in all the Oneflow templates to connect these templates to HubSpot.

You need to activate the HubSpot template group separately for each template:

  1. In the Oneflow app, go to Templates and click Create template or open an existing template to connect to HubSpot.


    The template must be active in Oneflow to show up in HubSpot.

  2. In the Settings tab, Template groups field, select HubSpot

  3. After setting up the template group, you can create data fields for information that should be automatically passed from HubSpot to your Oneflow contract.
    Click a form field in your template, and then click the tag icon (data field) in the toolbar. A list of the available data fields will display. 


    If your template has no Form field, you can add one by clicking the + icon > Form > Add field.
  4. In the Data field, select a predefined data field and click Save.

  5. The data fields get marked with a link symbol when you add data fields to a Form section.

  6. When you're done with creating the template, click Save template changes.

Get started with the Oneflow widget in HubSpot

Now that the Oneflow setup is done, you can start using the Oneflow integration in HubSpot:

  1. In HubSpot, open any deal or create a new one; the Oneflow module will display in the right pane.

Registration number mapping

The registration number of the company (Reg No.) is transferred from the company's Organization number (Org noin HubSpot and looks as follows in the Oneflow contract:

As a Oneflow admin, you can change the field set as the registration number in the company settings in HubSpot. 

To change the registration number field:

  1. In the Oneflow pane of a HubSpot deal, click Settings.

  2. Select a field in the Company registration number mapping field with which you want to map the company registration number.

Stage mapping

The Oneflow x Hubspot integration enables you to manage deal stages in different pipelines according to the contract status created from the deal with pre-configured values. You can set up this functionality under the Stage mapping tab on the Oneflow  Settings page.

To configure Stage mapping, you need to be logged in to HubSpot as admin. Once configured, the deal stage will be updated automatically when the contract status is changed.
Stage mapping does not affect deals with multiple contracts.

Configure stage mapping

To configure stage mapping:

  1. Click the Stage mapping tab.
    The system will display the list of Pipelines in your Hubspot account, and you can configure stage mapping for each.

  2. Select the pipeline to which you want to configure the stage mapping.

  3. Click the toggle button to enable stage mapping for the selected pipeline.

  4. You can select the targeted deal stage for each contract status change. The deal stages in the dropdown are based on the selected pipeline.

    Please note that you can opt for No stage change if you don’t need any stage change for a particular contract status change.
  5. Apply the changes before you navigate to configure another pipeline.

  6. You can configure stage mapping for every pipeline and individually enable or disable it.

Two-way sync

Under the Two-way sync tab in Settings, you can link HubSpot properties to data fields in Oneflow. This enables you to keep your data in sync on both platforms. 

To learn more, see Mapping HubSpot Properties and Two-way sync.

Create new contract

Now that the setup is complete, you can create contracts in HubSpot using the Oneflow widget.

You can create contracts based on an existing deal, contact, or company or during the creation of a new one. 

You can now create up to 10 contracts per HubSpot deal, contact, or company.

See the following sections to learn more about these alternatives.

Existing deal

To create a contract from a HubSpot deal:

  1. In HubSpot, open a deal, and in the Oneflow pane, click the Create Contract button.

  1. The Oneflow - Create contract will appear. Select the Workspace, Template, and Contact, and then click Create Contract.

    Contact details such as email address and phone number also can be selected along with the type for each contact while creating a contract.


    Select at least one contact from the contact list to enable the Create Contract button.

  2. If the relevant Hubspot Deal has an associated company, it will be listed in the 'type' dropdown, along with an option to select if the contact is an 'individual'. In the instance of no organizations associated with the Hubspot deal, there will be only one option in the type dropdown as 'individual'. If the Hubspot Deal has a company associated with it, but the name of the company is missing, the dropdown will have an option as 'Undefined Company'.

  3. Click Navigate to contract to be redirected to the Oneflow application.
  4. In Oneflow, edit the contract per your needs and click Send to send the contract to all contract participants. 
    When you create a contract, the HubSpot deal will also display relevant information such as the deal owner, company, and contacts created for that deal:


The user can also view relevant warning messages when fields such as phone number or email address are missing or in an incorrect format.

New deal

Alternatively, you can create a contract while creating a new deal. 

In this case, perform the following:

  1. In HubSpot, click Sales > Deals and click Create deal.

  2. In the Create deal window, specify the Deal nameCompany, and contact, then click Create.

  3. The Contact and Company added above will display in the deal view. Click the Create Contract button in the Oneflow pane.

  4. The fields specified in Step 2 will automatically be populated in the Create Contract window. Click the Create Contract button.

  5. Click Navigate to contract to be redirected to the Oneflow application.

  6. The Company will be added as the counterparty in the Oneflow contract. The Company Contacts and contact information specified in Step 2 will appear as the contract participants.


  1. Open an existing company or create a new company in Hubspot. And in the Oneflow pane, click the Create Contract button.
  2. If you are creating a contract from an existing company, it is as same as creating from an existing deal.
  3. If you are creating contract via a new company, it is as same as creating from a new deal.
  4. When creating a contract from a company, all the contacts associated with the company will be added to the participants list, so that the user can select to add only the desired participants of the contract.
  5. There should be at least one contact for a company to create a contract from a company.


  1. Open an existing contact or create a new contact in Hubspot. And in the Oneflow pane, click the Create Contract button.
  2. If you are creating a contract from an existing contact, it is as same as creating from an existing deal.
  3. If you are creating a contract via a new contact, it is as same as creating from a new deal.
  4. When creating a contract from a contact, all the contacts of the company associated with the contact will be added to the participants list, so that the user can select to add only the desired participants of the contract.
  5. Contracts cannot be created from a contact, if there is no company associated with the contact or the associated company doesn't have any contacts.

Did you find it helpful? Yes No

Send feedback
Sorry we couldn't be helpful. Help us improve this article with your feedback.