Skip to main content

HubSpot Connections

HubSpot is an inbound marketing and sales platform that offers marketing, sales, customer service, and CRM software. For more information, see https://www.hubspot.com/.

Tip

This connection is in early preview. It is read-only and available only in SaaS product editions. For more information on early previews, see Early Preview Connection Types.

Limitations and Requirements

Note

During normal selection or import of an entire table, you may encounter an error indicating a problem with a specific column. Since some tables require filtering based on a particular column, data from them can only be ingested using custom SQL statements. In this case, the problematic column can be used as a filter in the WHERE clause of a custom SQL statement to ingest the table.

  • For more information, please consult the CData driver documentation for the specific table.

  • For more information on using custom SQL, see Create Dataset with SQL.

Note

For filtering date columns, this connection type supports a set of literal functions on dates. You can use these to reduce the volume of data extracted from the database using a custom SQL query. For more information, see the pg_dateliteralfunctions.htm page in the driver documentation for this connection type.

  • Supports OAuth 2.0 and Private app authentication.

  • Based upon the availability of features in your Organization's HubSpot account, some tables may be unavailable. An error message is displayed when you try to ingest data from such tables. Contact your HubSpot administrator for further information.

Create Connection

via Cloud Portal

When you create the connection, please review the following properties and specify them accordingly:

Connection Property

Description

Connect String Options

The following default value sets the connection timeout in seconds:

Timeout=0;

Setting this value to 0 disables timeouts.

Credential Type

Select the required credential type. Below are the details.

  • API Key: Paste the API key used to access your HubSpot account.

    Note

    API Keys are being deprecated and are no longer supported. For more information, see https://knowledge.hubspot.com/integrations/how-do-i-get-my-hubspot-api-key.

  • OAuth 2.0 client: Select the client from the drop-down.

    Note

    After you have specified the connection to use OAuth 2.0, click Authenticate to validate the connection with the target datastore. If you have modified the connection, click Re-authenticate to validate the new connection definition. You must re-authenticate if you receive an expired code message. This step is required. For more information, see Enable OAuth 2.0 Authentication.

    Note

    As HubSpot is a tenant-based system, you must create and register a HubSpotOAuth 2.0 client in Alteryx Analytics Cloud (AAC). For more information, see OAuth 2.0 for Hubspot.

  • Private App: Paste your private app token. For more information on creating the token, see Private App for Hubspot.

Default Column Data Type Inference

Leave this value as Enabled.

For more information, see the driver documentation https://cdn.cdata.com/help/DHH/jdbc/default.htm.

via API

Depending on your product edition, you can create connections of this type. Key information:

"vendor": "hubspot",
"vendorName": "Hubspot",
"type": "jdbc"

Data Type Conversions

For more information, see the driver documentation https://cdn.cdata.com/help/DHH/jdbc/default.htm.