Programmers reference for HubSpot Reader
In TQL, the adapter is referenced in the Global namespace as Global.HubSpotReader.
HubSpot Reader properties
Property | Type | Default value | Notes |
|---|---|---|---|
Auth Mode | Select list
| ||
Client ID | String | Required for authentication with OAuth. | |
Client secret | Password | Required for authentication with OAuth. | |
Connection pool size | Integer | 20 | Specifies the number of connections in use. |
Connection profile name | String | Used when Some HubSpot objects cannot be read when HubSpot Reader uses a connection profile. See Objects not supported when using a connection profile. | |
Exclude tables | String | A list of tables excluded from read operations. Typically used to create a list of exceptions when the Tables property includes wildcards. Misconfiguration of the Tables and Exclude Tables properties can cause "Invalid table names" errors. | |
Incremental load marker | String | Value of the | The incremental load marker is a unique incremental column in each object used for incremental load. When no marker is specified, tables are resynced at each polling interval. |
Migrate schema | Boolean | False | Only available in Initial Load or Automated mode. Set to |
Mode | Select list
| Automated mode applies incremental updates to objects that support incremental load and performs full resyncs for objects that do not support incremental load. | |
Polling interval | String | 5m | Specifies an interval as an integer followed by a unit. Supported units are days ( |
Private app token | Password | Required for authentication with a private app token. | |
Refresh token | Password | Required for authentication with OAuth. | |
Start position | String | %=-1 | Value of the incremental load marker that defines the initial reading position. |
Use connection profile | Boolean | Set to True to use a connection profile instead of specifying the connection properties here. | |
Tables | String | A semicolon-delimited ( | |
Thread pool counter | Integer | 10 | The number of parallel running threads. The default value of zero specifies single-threaded operation. When the value of the thread pool counter is higher than the connection pool size, large data ingestion operations can cause the app to halt. Since best performance is achieved when using one thread for each table being synced, increasing the size of the connection pool to match the number of threads in use is a performance best practice. The |
Supported objects
The HubSpot Reader supports the following HubSpot objects. Each object lists the scopes an account must have in order to access that object.
Table | Scopes |
|---|---|
Companies |
|
Contacts |
|
Deals |
|
DealPipelines |
|
DealPipelineStages |
|
FeedbackSubmissions |
NoteRequires an Enterprise account. |
Forms |
|
LineItems |
|
Products |
NoteThis scope requires a HubSpot Professional or Enterprise account. |
Quotes |
|
Tickets |
|
TicketPipelines |
|
TicketPipelineStages |
|
EngagementsCalls |
|
EngagementsEmails |
|
EngagementsMeetings |
|
EngagementsNotes |
|
EngagementsTasks |
|
Owners |
|
Goals |
NoteThis scope requires a HubSpot Sales Hub Starter, Professional, or Enterprise account. |
CustomObjects |
NoteThis scope requires a HubSpot Enterprise account.
|
The HubSpot Reader also supports the following association objects.
CallAssociations
CompanyAssociations
ContactAssociations
CustomObjectAssociations
DealAssociations
EmailAssociations
FeedbackSubmissionAssociations
LineItemAssociations
MeetingAssociations
NoteAssociations
QuoteAssociations
TaskAssociations
TicketAssociations
Objects not supported when using a connection profile
HubSpot Reader cannot read the following objects when Use connection profile is True, because the connection profile does not grant the authorization scopes those objects require.
InvoiceAssociations
Invoices
ListMemberships
Lists
MarketingEmails
PostalMailProperties
PostalMails
TaskAssociations
If an application requests one of these objects through a connection profile, the source halts with a missing scopes error.
To read these objects, set Use connection profile to False and authenticate with a private app token or with OAuth, using credentials that include the scopes each object requires.