Getting started with Devart ODBC Driver for HubSpot

Quick start: Connect to HubSpot with ODBC

To connect to HubSpot using the Devart ODBC Driver:

1. Download and install the Driver for Windows.
2. Activate the Driver using your activation key, or continue with the 30-day trial.
3. Create an ODBC data source (DSN) and select Devart ODBC Driver for HubSpot.
4. Configure the connection by authenticating via OAuth 2.0 and the Refresh Token or via a Private App.
5. Use the DSN in your ODBC-compatible application to connect to HubSpot and work with its data.

The following sections provide detailed installation and configuration instructions.

Prerequisites

Before you begin, make sure your environment meets the following requirements:

• Operating system: 32-bit or 64-bit Windows (including Windows Terminal Server). The Driver is compatible with all Windows versions (Windows Vista and later) that support .NET Framework 4.5.
• ODBC driver manager: Included with Windows.
• Connection details: An active HubSpot account; Private App with access token if applicable.
• Activation key: A purchased version of the Driver requires an activation key. For evaluation purposes, you can use the trial version, which is valid for 30 days from installation.
• Administrator rights: Required to install the Driver on all supported operating systems.

For a complete list of supported platforms and third-party tools, see the ODBC Driver for HubSpot compatibility page.

Install the ODBC Driver

Installing the Devart ODBC Driver for HubSpot is straightforward. All you need to do is download the package for your operating system (Windows) and follow the installation instructions.

1. Download the ODBC Driver for HubSpot from the Devart website, open it, and click Next.

2. Read the License Agreement, select I accept the agreement, and click Next.

3. On the Select Destination Location page, keep the default folder or click Browse to choose another one, and click Next.

4. On the Select Components page, select the components to install, then click Next.

5. On the Select Start Menu Folder page, specify the folder for the Driver shortcuts. To skip creating a Start Menu folder, select Don't create a Start Menu folder. Click Next, then click Install.

6. On the License Information page, select Input activation key and enter your key. You can find it in the registration email or your Customer Portal. To open the Customer Portal, click Get Activation Key.

If the activation key is saved on your computer, click Load Activation Key and select the corresponding file.

To evaluate the Driver without a purchased key, select Trial evaluation.

7. Click Next, then click Finish to complete the installation.

Configure an ODBC data source

In this guide, you create a Data Source Name (DSN) for the ODBC connection and verify the connection details. A DSN stores connection settings, such as the authentication type and token that applications use to connect to HubSpot. Applications can also connect without a DSN, by passing the same parameters in a connection string.

To configure an ODBC data source, follow the steps outlined below.

1. In Windows Search, enter ODBC Data Sources, and open the ODBC Data Source Administrator that matches the bitness of your application.

2. Go to the User DSN, System DSN, or File DSN tab, and click Add:

• User DSN — Available only to the user who creates it.
• System DSN — Available to all users on the computer.
• File DSN — Stores connection settings in a file that can be shared between computers where the required ODBC driver is installed.

3. In the Create New Data Source dialog, select Devart ODBC Driver for HubSpot, and click Finish.

4. In the Devart ODBC Driver for HubSpot Configuration dialog, enter a Data Source Name and an optional Description.

5. To authenticate, you can use either OAuth 2.0 authentication (the default method) or the Private App authentication.

If you are authenticating via OAuth 2.0:

• Click Sign in to HubSpot to obtain the Refresh Token.
• Sign in to your HubSpot account and perform the necessary steps to allow connecting Devart ODBC Driver to HubSpot.
• The Refresh Token field is filled automatically. Select Save Token to store it.

If you are authenticating via your Private App:

• Obtain the access token: go to your Private App page, click Show token, and copy the access token.
• Select Private App in the Authentication field and enter the access token.

6. Optional: Click Test Connection to verify the connection settings.

7. Click OK to save the DSN settings.

To fine-tune metadata, timeout, and compatibility behavior, use the Advanced Settings tab of the same dialog.

Connect to HubSpot using a connection string

In addition to using a DSN, you can connect to HubSpot by specifying the connection parameters directly in an ODBC connection string. This type of connection is known as a DSN-less connection.

The following table summarizes when to use each connection method.

For OAuth 2.0 authentication, use the following connection string configuration.

DRIVER={Devart ODBC Driver for HubSpot};Authentication=OAuth;Refresh Token=mytoken

Replace the "mytoken" placeholder with your actual HubSpot refresh token.

For Private App authentication, use the connection string configuration as shown below.

DRIVER={Devart ODBC Driver for HubSpot};Authentication=Private App;Access Token=myaccesstoken

Replace the "myaccesstoken" placeholder with your actual Private App access token.

Troubleshooting

If you cannot connect to HubSpot through the Devart ODBC Driver, refer to the following list of common connection issues and their solutions to troubleshoot and fix the problem.

"Product is not activated or has been deactivated" error

This error occurs when the Driver has not been activated or its activation is no longer valid. Activation is required for both purchased and trial versions.

Open the DSN configuration dialog, go to the License tab, click Input Activation Key, and enter your activation key. After activation, test the connection again.

ODBC data source not found or Driver not available

If your application cannot find the DSN or the Devart ODBC Driver for HubSpot, check the application and Driver bitness.

A 32-bit application cannot use a DSN created in the 64-bit ODBC Data Source Administrator, and a 64-bit application cannot use a DSN created in the 32-bit administrator.

Make sure that:

• The DSN is created in the ODBC administrator that matches your application's bitness.
• The corresponding 32-bit or 64-bit version of the Driver is installed.
• The application is configured to use the correct DSN.

Connection fails

If HubSpot is reachable but authentication fails, check the authentication option. The Driver supports both OAuth and Private App; ensure that the required tokens for the selected method are provided.

• If you use OAuth, sign in to HubSpot again and reconnect the Driver by following the required steps. After successful authorization, the Refresh Token field is populated with a new token automatically.
• If you use the Private App authentication option, obtain a valid access token for the Private App and enter it in the Access Token field.

HubSpot connection times out

If the connection to HubSpot takes too long to establish, increase Connection Timeout on the Advanced Settings tab. Also, check the network connection.

Additional resources

After you install and configure Devart ODBC Driver for HubSpot, use the following resources to continue setting up and working with your connections:

• Connection string parameters — Browse the complete list of connection options for configuring authentication, proxy settings, timeouts, ODBC behavior, and other Driver settings.
• Supported ODBC API functions — Explore the currently supported ODBC functions.
• Using in third-party tools — Find step-by-step guides for connecting BI, reporting, analytics, and other ODBC-compatible tools to HubSpot.
• Documentation — Get full information on installing, configuring, and using the Devart ODBC Driver for HubSpot.