Hubspot Connector

ZappySys Hubspot Connector provide read / write capability inside your app (see list below), using these drag and drop , high performance connector you can perform many Hubspot operations without any coding. You can use this connector to integrate Hubspot data inside apps like SSIS, SQL Server or popular ETL Platforms / BI Tools/ Reporting Apps / Programming languages (i.e. Informatica, Power BI, SSRS, Excel, C#, JAVA, Python)

Download for SSIS Download for Other Apps Documentation

Click on your App below to get started with Hubspot Integration

Choose your App / Scenario for which you like to integrate Hubspot

Actions supported by Hubspot Connector

Hubspot Connector support following actions for REST API integration. If some actions are not listed below then you can easily edit Connector file and enhance out of the box functionality.
 Search Companies
Search companies using one or more filter conditions. Choose properties to include in the output.    [Read more...]
Parameter Description
Properties
 Search Contacts
Search contacts using one or more filter conditions. Choose properties to include in the output.    [Read more...]
Parameter Description
Properties
 Search Tickets
Search tickets using one or more filter conditions. Choose properties to include in the output.    [Read more...]
Parameter Description
Properties
 Search Deals
Search deals using one or more filter conditions. Choose properties to include in the output.    [Read more...]
Parameter Description
Properties
 Search Products
Search products using one or more filter conditions. Choose properties to include in the output.    [Read more...]
Parameter Description
Properties
 Search LineItems
Search LineItems using one or more filter conditions. Choose properties to include in the output.    [Read more...]
Parameter Description
Properties
 Search Quotes
Search Quotes using one or more filter conditions. Choose properties to include in the output.    [Read more...]
Parameter Description
Properties
 Get Contacts
   [Read more...]
Parameter Description
Properties
 Get Contact By ID
   [Read more...]
Parameter Description
Properties
 Get Contact Properties
   [Read more...]
 Create Contacts
   [Read more...]
 Update Contacts
   [Read more...]
 Archive Contacts
   [Read more...]
 Get Deals
   [Read more...]
Parameter Description
Properties
 Get Deal Properties
   [Read more...]
 Get Deal By ID
   [Read more...]
Parameter Description
Properties
 Create Deals
   [Read more...]
 Archive Deals
   [Read more...]
 Update Deals
   [Read more...]
 Get Products
   [Read more...]
Parameter Description
Properties
 Get Product By ID
   [Read more...]
Parameter Description
Properties
 Get Product Properties
   [Read more...]
 Create Products
   [Read more...]
 Archive Products
   [Read more...]
 Update Products
   [Read more...]
 Get Companies
   [Read more...]
Parameter Description
Properties
 Get Company By ID
   [Read more...]
Parameter Description
Properties
 Get Company Properties
   [Read more...]
 Create Companies
   [Read more...]
 Archive Companies
   [Read more...]
 Update Companies
   [Read more...]
 Get Line Items
   [Read more...]
Parameter Description
Properties
 Get Line Item By ID
   [Read more...]
Parameter Description
Properties
 Get Line Item Properties
   [Read more...]
Parameter Description
 Create Line Items
   [Read more...]
Parameter Description
 Archive Line Items
   [Read more...]
 Update Line items
   [Read more...]
 Get Tickets
   [Read more...]
Parameter Description
Properties
 Get Ticket By ID
   [Read more...]
Parameter Description
Properties
 Get Tickets Properties
   [Read more...]
Parameter Description
 Create Tickets
   [Read more...]
 Archive Tickets
   [Read more...]
 Update Tickets
   [Read more...]
 Get Quotes
   [Read more...]
Parameter Description
Properties
 Get Quote By ID
   [Read more...]
Parameter Description
Properties
 Get Quotes Properties
   [Read more...]
Parameter Description
 Create Quotes
   [Read more...]
 Archive Quotes
   [Read more...]
 Update Quotes
   [Read more...]
 Get Owners
   [Read more...]
Parameter Description
OwnerId
 Upload File from Local Disk
Uploads local file to Hubspot CRM. This API requires files permission for the App (see scopes)    [Read more...]
Parameter Description
Source File Path Specify a disk file path
Target Folder Path Specify Target folder path. Partially optional field. One of folderPath or folderId must be specified. Path of the folder the file should be uploaded into. Uploading files into the root path “/” is highly discouraged.
Target File Name (e.g. MyFile.xlsx) Specify file name you like to give
AccessType Specify file access type
Option Value
PRIVATE PRIVATE
PUBLIC_NOT_INDEXABLE PUBLIC_NOT_INDEXABLE
PUBLIC_INDEXABLE PUBLIC_INDEXABLE
Overwrite Specify wheather you like to overwrite target file if exists. If true this file with replace any existing files with the name, folder, and type. Note: If this is set to false, and the uploaded file matches the filename of an existing file in the same folder, the file will be uploaded with a number incremented filename (e.g. example_file.txt will become example_file-1.txt)
Option Value
false false
true true
DuplicateValidationStrategy Specify how to handle duplicate target file.
Option Value
NONE NONE
REJECT REJECT
RETURN_EXISTING RETURN_EXISTING
DuplicateValidationScope Specify scope of duplicate validation.
Option Value
EXACT_FOLDER EXACT_FOLDER
ENTIRE_PORTAL ENTIRE_PORTAL
 Generic Request
This is generic endpoint. Use this endpoint when some actions are not implemented by connector. Just enter partial URL (Required), Body, Method, Header etc. Most parameters are optional except URL.    [Read more...]
Parameter Description
Url API URL goes here. You can enter full URL or Partial URL relative to Base URL. If it is full URL then domain name must be part of ServiceURL or part of TrustedDomains
Body Request Body content goes here
IsMultiPart Set this option if you want to upload file(s) (i.e. POST RAW file data) or send data using Multi-Part encoding method (i.e. Content-Type: multipart/form-data). Multi-Part request allows you to mix key/value and upload files in same request. On the other hand raw upload allows only single file upload (without any key/value) ==== Raw Upload (Content-Type: application/octet-stream) ===== To upload single file in raw mode check this option and specify full file path starting with @ sign in the Body (e.g. @c:\data\myfile.zip ) ==== Form-Data / Multipart Upload (Content-Type: multipart/form-data) ===== To treat your Request data as multi part fields you must specify key/value pairs separated by new lines into RequestData field (i.e. Body). Each key value pair is entered on new-line and key/value are separated using equal sign (=). Preceding and trailing spaces are ignored also blank lines are ignored. If field value has some any special character(s) then use escape sequence (e.g. For NewLine: \r\n, For Tab: \t, For at (@): \@). When value of any field starts with at sign (@) its automatically treated as File you want to upload. By default file content type is determined based on extension however you can supply content type manually for any field using this way [ YourFileFieldName.Content-Type=some-content-type ]. By default File Upload Field always includes Content-Type in the request (non file fields do not have content-type by default unless you supply manually). For some reason if you dont want to use Content-Type header in your request then supply blank Content-Type to exclude this header altogather [e.g. SomeFieldName.Content-Type= ]. In below example we have supplied Content-Type for file2 and SomeField1, all other fields are using default content-type. See below Example of uploading multiple files along with additional fields. If some API requires you to pass Content-Type: multipart/form-data rather than multipart/form-data then manually set Request Header => Content-Type: multipart/mixed (it must starts with multipart/ else will be ignored). file1=@c:\data\Myfile1.txt file2=@c:\data\Myfile2.json file2.Content-Type=application/json SomeField1=aaaaaaa SomeField1.Content-Type=text/plain SomeField2=12345 SomeFieldWithNewLineAndTab=This is line1\r\nThis is line2\r\nThis is \ttab \ttab \ttab SomeFieldStartingWithAtSign=\@MyTwitterHandle
Filter Enter filter to extract array from response. Example: $.rows[*] --OR-- $.customers[*].orders[*]. Check your response document and find out hierarchy you like to extract
Headers Headers for Request. To enter multiple headers use double pipe or new line after each {header-name}:{value} pair

Hubspot Connector Examples (For ODBC PowerPack)

This page offers a collection of SQL examples designed for seamless integration with the ZappySys API ODBC Driver under ODBC Data Source (36/64) or ZappySys Data Gateway, enhancing your ability to connect and interact with Prebuilt Connectors effectively.

Get companies    [Read more...]

Gets companies

SELECT * FROM Companies --Where Id=123

Get contacts    [Read more...]

Gets contacts

SELECT * FROM Contacts --Where Id=123

Get contact by Id    [Read more...]

Gets contact by Id

SELECT * FROM Contacts Where Id=51

Get contact by email (search)    [Read more...]

Gets contacts

SELECT Id
	, IsArchived
	, CreatedAt
	, UpdatedAt
	, email
	, firstname
	, lastname
	, company_size
	--, custom_checkbox
	--, custom_multi_select
	--, custom_number
	--, custom_pickuser
	--, custom_richtext
	--, custom_string
	--, custom_string_multi
FROM search_contacts
With(SearchFilters='[ {"propertyName": "email", "operator": "EQ", "value": "bh@hubspot.com" } ]')

Get deals    [Read more...]

Gets deals

SELECT * FROM Deals --Where Id=123

Get line items    [Read more...]

Gets line items

SELECT * FROM LineItems --Where Id=123

Get owners    [Read more...]

Gets owners

SELECT * FROM Owners

Get products    [Read more...]

Gets products

SELECT * FROM Products --Where Id=123

Get tickets    [Read more...]

Gets tickets

SELECT * FROM Tickets

Get quotes    [Read more...]

Gets quotes

SELECT * FROM Quotes

Generic Request (Company Search API Example)    [Read more...]

This example shows how to invoke generic request when connector file doesnt have specific EndPoint / Table you like to query. This example invokes search endpoint but you can call any valid API endpoint GET/POST etc with this method

SELECT *
FROM generic_request
WITH(
     Url='crm/v3/objects/companies/search'
    ,Filter='$.results[*]'
    ,RequestContentTypeCode='ApplicationJson'
    ,RequestMethod='POST'
    ,RequestData='{
        "filters": [ {"propertyName": "hs_lastmodifieddate", "operator": "GT", "value": "<<yearstart-1y||unix_timestamp_ms,FUN_TO_DATE>>" } ],
        "properties": ["address","city","state"]  
        }'
)

Upload File (Generic Request Example)    [Read more...]

This example shows how to upload a file using generic request. You might have to add file-manager-permission to your OAuth App else you might get message=This oauth-token (CJT87I6) does not have proper permissions! (requires any of [file-manager-access]). For more information please refer to this link https://developers.hubspot.com/docs/api/files/files

SELECT *
FROM generic_request
WITH(
	  Url='filemanager/api/v3/files/upload'
	, RequestMethod='POST'
	, Filter ='$.objects[*]'
	, Body='file=@c:\temp\dump.png
folderPath=/
fileName=my_dump.png
options={"access": "PRIVATE", "overwrite": true}'
	, IsMultiPart='True'
	, Meta='id:long; name:string; title:string; url: string; type:string; size:long; friendly_url:string; meta.allows_anonymous_access:string; meta.indexable:bool'
)

Insert into Contacts    [Read more...]

Inserts contacts

INSERT INTO Contacts(email, firstname, lastname,custom_checkbox, custom_date, custom_number)
VALUES ('john.doe@abc.com', 'John', 'Doe','true','2023-01-01', 100.55)

Update Contacts    [Read more...]

Updates contacts in your account

UPDATE Contacts
SET firstname = 'Brian'
   ,lastname = 'Halligan (Sample Contact)'
   --,custom_number=12.12
   --,custom_date='2023-01-01'
   --,custom_string='My Test<<FUN_NOW>>'
   --,custom_richtext='<p><span style="color: #b5b5b5;">##-Please reply-##</span></p>'
   --,custom_multi_select='Blue;Yellow;Black'
   --,custom_pickuser=45581955
   --,custom_dropdown='BB'
   --,custom_checkbox='true'   
WHERE Id = 51

Delete a contact    [Read more...]

Deletes a contact

DELETE FROM Contacts Where Id=1234

Create multiple records - (BULK read / write from external source)    [Read more...]

This examples shows how to perform bulk update using SOURCE clause. It reads data from external system (in this example MS SQL Server) and sends data to Hubspot using Bulk API

INSERT INTO Contacts 
SOURCE(
  'MSSQL' --ODBC or OLEDB
  ,'Data Source=localhost;Initial Catalog=Test;Integrated Security=true'
  ,' 
    ''bob'' as firstname, ''rock'' as firstname, ''new-email1@abc.com'' as email
    UNION 
    ''sam'' as firstname, ''smith'' as firstname, ''new-email2@abc.com'' as email
)

Delete multiple records - (BULK read / write from external source)    [Read more...]

This examples shows how to perform bulk delete using SOURCE clause. It reads data from external system (in this example MS SQL Server) and sends data to Hubspot using Bulk API

DELETE FROM Contacts 
SOURCE(
  'MSSQL' --ODBC or OLEDB
  ,'Data Source=localhost;Initial Catalog=Test;Integrated Security=true'
  ,'select 104897 as Id 
    UNION 
    select 104898 as Id'
)

Update multiple records - (BULK read / write from external source)    [Read more...]

This examples shows how to perform bulk update using SOURCE clause. It reads data from external system (in this example MS SQL Server) and sends data to Hubspot using Bulk API

UPDATE Contacts 
SOURCE(
  'MSSQL' --ODBC or OLEDB
  ,'Data Source=localhost;Initial Catalog=Test;Integrated Security=true'
  ,'select 104811 as Id, ''new-email1@abc.com'' as email
    UNION 
    select 104812 as Id, ''new-email2@abc.com'' as email
)

Download for SSIS Download for Other Apps