- Starter
- Business
- Enterprise
- On-Premise
- Add-on
Overview
Etlworks HubSpot connector allows fast, real-time access to HubSpot data. The connector supports most of the objects available through the HubSpot API and works like any other connector for connected app.
Etlworks partnered with CData to provide access to the HubSpot API using industry-standard JDBC protocol. Read about the CData HubSpot JDBC connector.
When to use HubSpot connector
Use this connector to create Flows that work with data in HubSpot.
Alternative: Free API Connector
In addition to this native connector, Etlworks also offers a generic API Connector that can be used to connect to this platform via its public API. The API connector is free and is a good alternative when the native connector doesn’t support a specific feature or if you prefer working directly with the API.
Prerequisites
Enable HubSpot connector for your Etlworks account. Contact support@etlworks.com to enable the connector.
Create a Connection
Step 1. In the Connections window, click +, and type in hubspot. After which, select Hubspot.
Step 2. Optionally select OAuth scopes. The default scope contacts is always selected.
Step 3. Authorize the HubSpot app to access your HubSpot data.
Step 4. Test and save the Connection.
Connection parameters
Use Other parameters to specify the Connection string options. Read about available Connection string options.
HubSpot data model
Our connector models HubSpot entities as relational Tables, Views, and Stored Procedures.
Read about the HubSpot data model.
Stored procedures
Stored procedures are available to complement the data available from the Data Model. It may be necessary to update data available from a view using a stored procedure because the data does not provide for direct, table-like, two-way updates. In these situations, the data retrieval is done using the appropriate view or table, while the update is done by calling a stored procedure. Stored procedures take a list of parameters and return back a dataset containing the collection of tuples that constitute the response.
To call stored procure from the SQL Flow or from Before/After SQL, use EXEC sp_name params=value syntax. Example:
EXEC GetOAuthAccessToken scope = 'events-rw settings-rw contacts-rw offline'
Work with data in Hubspot
Extract data from HubSpot
Note: Extracting data from HubSpot is similar toextracting data from the relational database.
Step 1. Create a HubSpot Connection that will be used as a source (FROM).
Step 2. Create a destination Connection, for example, a Connection to the relational database, and if needed, a Format (Format is not needed if the destination is a database or well-known API).
Step 3. Create a Flow where the source is a connected app, and the destination is a Connection created in step 2, for example, a relational database.
Step 4. Add a new source-to-destination transformation.
Step 5. Select HubSpot Connection created in step 1 as a source Connection and select the HubSpot object you are extracting data from:
Step 6. Select TO Connection, Format (if needed), and object (for example, database table) to load data into.
Step 7. Click MAPPING and optionally enter Source Query (you don't need a query if you are extracting data from the HubSpot object unconditionally).
Step 8. Optionally define the per-field Mapping.
Step 9. Add more transformations if needed.
Load data in HubSpot
Note: Loading data in HubSpot is similar toloading data into a relational database.
Step 1. Create a source Connection and a Format (if needed).
Step 2. Create a destination HubSpot Connection.
Step 3. Create a Flow where the destination is a connected app.
Step 4. Add new source-to-destination transformation.
Step 5. Select FROM and TO Connections and objects (also a FROM Format if needed).
Step 6. Optionally define the per-field mapping.
Step 7. Add more transformations if needed.
Browse data in HubSpot
You must have a HubSpot Connection to browse objects and run SQL queries.
Use Etlworks Explorer to browse data and metadata in HubSpot and execute DML and SELECT queries against a HubSpot Connection.