Configure the integration - Field mapping and other settings

Introduction

The Hubspot integration is designed to streamline your business processes, making it easier for teams to create contracts directly within Hubspot in just a few clicks—without the need to log into SpotDraft separately. With our dynamic mapping feature, the integration can be configured to automatically populate contract details from Hubspot, eliminating the need for manual data entry when the information is already available.

What's new?

The Hubspot integration with SpotDraft has become more powerful, stable, fast, and user-friendly with this release. The summary of the main changes is the following:

1. Pick values from deeply nested fields: This version addresses the challenge of retrieving information from deeply nested fields. Now, you can fetch data from child relationships, providing flexibility for handling more complex data structures in real-world scenarios.
2. Self-serve setup: The setup process has been significantly simplified. Previously, it involved a highly technical and complex user interface. The process is now quicker, more intuitive and does not require technical expertise to configure or manage.
3. Multiple connections: You can now connect multiple accounts to the same workflow, allowing both Sandbox and Production accounts to co-exist. In the previous version, only one account could be active at a time. Now, both accounts can work in parallel, streamlining your workflow management across environments.
4. Better error handling: The previous version would fail completely if any field mapping encountered an issue. For instance, if you had 25 mapped fields and just one had incorrect mapping or data type problems, all 25 fields would fail to auto-populate. With the new integration, the system intelligently proceeds with 24 successful fields while only the problematic field remains empty, ensuring continuity in your workflow.
5. Enhanced error reporting: The new version provides clear visibility into the relationship between Hubspot fields and SpotDraft fields. When errors occur, users receive targeted notifications with descriptive icons indicating the specific issue—whether it's a missing value, unsupported data type, or incompatible value format. This transparency eliminates guesswork and accelerates troubleshooting.
6. Significantly improved speed: By eliminating the dependency on external services that previously mediated the Hubspot-SpotDraft connection, the new version delivers substantially faster performance. This architectural improvement not only makes the application more responsive but also enables our team to identify and resolve potential issues with greater efficiency and precision.

Step-by-step installation guide

This guide will walk you through the simple steps to set up the integration.

Step 1: Authentication

1. Navigate to Settings > Integrations > CRM > Hubspot and go to the Setup tab.
2. Click on the View Hubspot Authentications button. A sidesheet will open.
   
3. Click on the Add New Authentication button.
4. Fill in the authentication name which will be used to identify the authentication (Eg: Acme Production) uniquely.
   
   
5. A new window will open with the Hubspot login page. Log in using your Hubspot credentials to authorize SpotDraft to access your Hubspot account.

Note:

• It’s recommended to use an Incognito window for this step as you could be logged into multiple Hubspot accounts and could incorrectly select an account.
• It is recommended to use a generic account (eg: spotdraft_integration@acme.com) for authentication which is not tied to an individual. If the individual leaves the organization and their account is deactivated, the integration will stop functioning until reauthenticated.
• The authentication expires if the integration remains unused for a long period or if your Hubspot admin makes some changes. In such cases, you can re-authenticate it from the UI.

Step 2: Adding an integration and enabling it

1. Click on the Add Integration button. A sidesheet will open.
2. Fill in the following information:
   • Integration Name: A unique identifier for the integration (Eg: Production Account)
   • Integration Description: A brief description to identify what this is used for
   • Authentication: Select which authentication should be used for this integration
     
3. Click on the Connect button.

The integration remains disabled by default. Remember to enable the integration that was created

1. Click on the 3-dot menu.
2. Click on the Enable option.
3. Click on the Enable button on the modal after carefully reading the message.
   

Step 3: Configure Global Settings

1. SpotDraft allows you to set global or generic settings for your workflows. These settings include fields like Counterparty Name and Points of Contact, which are used across workflows.
2. Once you select the necessary Hubspot objects, click Configure to open a sidesheet with three tabs (Note: We currently support contract creation only from the Deal object. Support for more objects will be added soon.)
   
   
3. Fill in the required information in each tab. You will be able to save the configuration only after all mandatory fields are completed.
4. After saving, proceed to the next step.
   

Tip:
You can also configure options such as:

• When users can create contracts.
• Whether users can manually edit mapped fields.

Step 4: Select Workflows to Configure

Not all SpotDraft workflows need to be integrated with Hubspot. Here, you can choose which workflows to expose for your Sales team.

Step 5: Map Workflow Questions to Hubspot Fields

One of the key features of the Hubspot integration is the ability to map SpotDraft workflow questions to Hubspot fields. This eliminates manual data entry when creating contracts, as the integration pulls relevant data directly from Hubspot.

1. Click on Map Questions next to the workflow you want to configure. This will open the workflow questionnaire in a new tab.
   
2. For each question you wish to map, click Edit. In the sidesheet that opens, navigate to the Linked Source tab.
3. Select the appropriate Hubspot field to map to the selected SpotDraft question.

Step 6: Publish the workflow

Once the required mappings are done, publish the workflow for the changes to take effect.
Note: This will apply only to newly created contracts. The in-flight contracts will continue to use the previous configuration.

Step 7: Enable the workflow

If you have not already enabled the workflow, return to the workflow selection page and enable it to become available on Hubspot.