Submit a ticket
Welcome
Login

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

Note:

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 by clicking the toggle.
  2. Click on Details in the HubSpot card 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.
    Alternatively, click on Template library, select a template, and click on Confirm.

  2. In the Settings tab, Template group 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 (Optional). 

    You may add data fields to a text or form section in your Oneflow template.

    To add a data field to a text section in your template, move the cursor to the place you wish to add a data field, then click on the tag icon (insert data field) in the toolbar. A list of the available data fields will be displayed. Select a field, then press Confirm.


    To add a data field to a form section, click on a field in the form, then select the field from the data field dropdown menu. In the Data field card, click Save.

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

    Note:

    If your template has no Form field, you can add one by clicking the + icon > Form > Add field.
  4. If you wish to attach files or PDFs to contracts, add an Attachments section and a PDF document section to your template (Optional).

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

  6. Click on the three dots menu, then select Activate Template.

    Note:

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

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.

Note:

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

    Note:
    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.

Information:
  • 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.

Before creating a contract:

  • Ensure the deal has at least one contact or company associated with it.
  • The contacts in the Create Contract window are populated with the contacts belonging to the company associated with the deal and/or other contacts added to the deal.

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.

  2. Select the Workspace, Template, and the contacts you want to add as participants to the contract.
    You can also attach files to the contract. Click on Upload Files to add files to the list, then select the files to add to the contract using the checkboxes.

    Contract Name: This field will be populated automatically in the Create Contract window based on the HubSpot deal name.

    Workspace: Select a Oneflow workspace to create the contract in.

    Template: Select a Oneflow template to create the contract from.

    Note:

    If you wish to attach files and/or expanded PDFs to your contract, select a template containing an Attachments section and/or a PDF documents section.

    Contacts: Select the contacts to add as participants to the contract using the checkboxes.

    Note:

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

    Type: Selecting the company name will add the contact as a participant under that company in the contract. Selecting “Individual” will add the contact as an individual participant in the contract.

    Note:

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

    Role in contract: Select a role for each participant in the contract.
    Signatory: can sign the contract.
    Influencer: can edit the contract.
    Viewer: can view and comment on the contract.

    Add PDFs/attachments: Any files already added as attachments to the HubSpot deal will be displayed in the list. You can also add files using the Upload Files button. Select the files to add to the contract using the checkboxes.

    Note:
    Only certain file types can be added as attachments to Oneflow contracts. See contract file extensions, to view a list of all supported file types.

    Expand in PDF Section: This option applies to PDF files. If the toggle is set to “Yes”, then the PDF file will be displayed in an expanded PDF section in the Oneflow contract. If the toggle is set to “No” then the PDF file will be added as a normal attachment in the contract.

  3. Click on the Create Contract button.

  4. Click Navigate to contract to be redirected to the Oneflow application.
  5. 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:

Note:

  • A relevant warning message will be displayed 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. Select the Workspace, Template, and the contacts you want to add as participants to the contract.
    You can also attach files to the contract. Click on Upload Files to add files to the list, then select the files to add to the contract using the checkboxes.

    Contract Name: This field will be populated automatically in the Create Contract window based on the HubSpot deal name.

    Workspace: Select a Oneflow workspace to create the contract in.

    Template: Select a Oneflow template to create the contract from.

    Note:

    If you wish to attach files and/or expanded PDFs to your contract, select a template containing an Attachments section and/or a PDF documents section.

    Contacts: Select the contacts to add as participants to the contract using the checkboxes.

    Note:

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

    Type: Selecting the company name will add the contact as a participant under that company in the contract. Selecting “Individual” will add the contact as an individual participant in the contract.

    Note:

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

    Role in contract: Select a role for each participant in the contract.
    Signatory: can sign the contract.
    Influencer: can edit the contract.
    Viewer: can view and comment on the contract.

    Add PDFs/attachments: Any files already added as attachments to the HubSpot deal will be displayed in the list. You can also add files using the Upload Files button. Select the files to add to the contract using the checkboxes.

    Note:
    Only certain file types can be added as attachments to Oneflow contracts. See contract file extensions, to view a list of all supported file types.

    Expand in PDF Section: This option applies to PDF files. If the toggle is set to “Yes”, then the PDF file will be displayed in an expanded PDF section in the Oneflow contract. If the toggle is set to “No” then the PDF file will be added as a normal attachment in the contract.

  5. Click on the Create Contract button.
  6. Click Navigate to contract to be redirected to the Oneflow application.

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

Company

  1. Open an existing company or create a new company in Hubspot. In the Oneflow pane, click on the Create Contract button.
  2. If you are creating a contract from an existing company in HubSpot, it is the same as creating from an existing deal.
  3. If you are creating a contract via a new company, it is the 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. You can then select which contacts you wish to add as participants to the contract using the checkboxes.
Note:
There should be at least one contact in a company to create a contract from a company.


Contact

  1. Open an existing contact or create a new contact in Hubspot. And in the Oneflow pane, click on the Create Contract button.
  2. If you are creating a contract from an existing contact, it is the same as creating from an existing deal.
  3. If you are creating a contract via a new contact, it is the same as creating from a new deal.
  4. When creating a contract from a contact in HubSpot, all the contacts of the company associated with the contact will be added to the participants list. You can then select which contacts you wish to add as participants to the contract using the checkboxes.
Note:
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.