HubSpot
HubSpot connections let Liberator read CRM objects (contacts, companies, deals, and related associations) and expose them as standard Liberator datasets. Once onboarded, HubSpot data uses the same entitlements, query API, and AI assistant surfaces as file- and database-backed sources.HubSpot connectivity is available in Liberator 2.3 and later.
Prerequisites
- A HubSpot account with API access to the objects you intend to query
- A HubSpot private app token (or equivalent API credential) with read scopes for those objects
- Admin or Super Admin role in Liberator to create connections and datasets
Connect HubSpot
1
Add a connection
Go to Connections → Add Connection and select HubSpot.
2
Enter credentials
Paste your HubSpot API token into the credential field. Liberator stores the secret with the connection and does not display it again after save.
3
Test connection
Click Test Connection. On success, Liberator can list available HubSpot objects for dataset onboarding.
4
Onboard a dataset
Create a dataset against the connection, choose the HubSpot object (or association view) to expose, and complete the usual column / timestamp mapping steps.
What you can query
HubSpot-backed datasets support the same Liberator query parameters as other sources (symbols / key fields, as_of, back_to, column selection, and so on), subject to the object schema HubSpot returns. Use them when you want CRM facts alongside market or file-backed datasets without a separate extract pipeline.
Tips
- Scope the HubSpot token to read-only access for the objects you need.
- Prefer one Liberator dataset per HubSpot object you query often; keep association-heavy views as separate datasets when schemas differ.
- After rotating a HubSpot token, update the connection credentials and re-test before users query.
Related
Datasource overview
Connection + dataset architecture and shared configuration fields
What's new in 2.3
Full Liberator 2.3 release notes