Using the HubSpot Query component in Matillion ELT for BigQuery

  • Laura Malins, ETL Product Manager
  • October 23, 2017

Matillion-HubSpotMatillion uses the Extract-Load-Transform (ELT) approach to deliver quick results for a wide range of data processing purposes, including everything from customer behaviour analytics, financial analysis, and even reducing the cost of synthesising DNA. The HubSpot Query component in Matillion ELT for BigQuery presents an easy-to-use graphical interface, enabling you to connect to HubSpot and pull data into BigQuery.

Customers typically use the HubSpot Query component in Matillion ELT for BigQuery to measure the effectiveness of their marketing by combining HubSpot data with other data sources, such as sales data, to get a holistic view.

This self-contained connector is included within the scope of a standard Matillion license, so there are no additional software installations required or associated costs.


Watch our tutorial video for a demonstration on how to set up and use the HubSpot Query component in Matillion ETL for BigQuery.


The first step in configuring the HubSpot Query component is to provide Matillion with Authentication to HubSpot.

The Matillion HubSpot component requires OAuth to be setup to authenticate access. Clicking on the 3 dots next to the Authentication property will bring a pop up box showing all available HubSpot OAuth set up in Matillion:


Data Source

Next, identify what data is to be loaded into BigQuery from the Data Source drop down.


Data Selection

In the Data Selection area choose the required fields from the data source. An example list of the fields available in the Data Source object selected, including any custom objects, is in the image below. This will form the new table which is created in BigQuery.


Data Source Filter

Use a filter to filter the returned data if required.

Running the HubSpot Query component in Matillion ELT for BigQuery

Before you run the component, give the Target Table a name. This is the name of the new table which will be created to write the data into in BigQuery. Additionally, specify a Cloud Storage Staging area; this is a Cloud Storage bucket which will temporarily store the results of the query before loading it into BigQuery.

The HubSpot Query component also has a Limit property, which you can use to force an upper limit on the number of records returned.

Once configured correctly, the border on the HubSpot icon will turn green.

To query your data and bring it into BigQuery, run the Orchestration job manually or by using the Scheduler.


Advanced Mode

The HubSpot Query component offers an “Advanced” mode instead of the default “Basic” mode.


In Advanced Mode, you can write a SQL-like query over all the available fields in the data model. This is automatically translated into the correct API calls to retrieve the data requested.

Transforming the Data

Once you have brought the required HubSpot data into BigQuery you can perform transformation jobs, such as combining the data with ERP data.


In this way, you can build out the rest of your downstream transformations and analysis, taking advantage of BigQuery’s power and scalability.

Useful Links

HubSpot Query component in Matillion ELT for BigQuery
Component Data Model
OAuth Set Up
Integration information

[callout-content title=”Want to try the HubSpot Query component in Matillion ELT for BigQuery? Request a free demo now, or launch on the Google Cloud Launcher.”]

[button title=”Request a Demo” link=””]

[button title=”Launch Now” link=”” style=”ghost”]