Configure HubSpot
At a glance
HubSpot is a CRM and marketing automation platform. With Ontologie, you can sync your contacts, companies, deals, tickets, and engagements into your workspace for analysis and workflow automation.
Before you start
- A HubSpot account with admin or super-admin access
- A HubSpot developer app or private app for OAuth authentication
Get credentials
- Go to HubSpot Developer Portal and sign in.
- Navigate to Apps and create a new app (or use an existing one).
- Under Auth, note the Client ID and Client Secret.
- Add the Ontologie callback URL to the Redirect URLs list.
Screenshots of the HubSpot developer portal will be added in a future update.
Configure in Ontologie
- Open Live Data > Connectors.
- Search for HubSpot in the catalogue.
- Click the HubSpot card.
- Follow the configuration wizard:
- Method: OAuth
- See the full guide: OAuth Connector
Available streams
| Stream | Description |
|---|---|
| Contacts | Contact records with properties and associations |
| Companies | Company records with properties and associations |
| Deals | Deal pipeline records with stages and amounts |
| Tickets | Support ticket records with status and priority |
| Engagements | Activities such as emails, calls, meetings, and notes |
Limits
| Limit | Value |
|---|---|
| API rate limit | 100 requests per 10 seconds (OAuth apps) |
| Records per request | 100 records per page |
| Search API | 4 requests per second per app |
Troubleshooting
| Error | Solution |
|---|---|
| 401 Unauthorized | Re-authenticate the connector; the OAuth token may have expired. |
| 403 Forbidden | Ensure the app has the required scopes (e.g., crm.objects.contacts.read). |
| Missing properties | Custom properties require the crm.schemas.read scope to be included. |
Expected result
Your data appears in Live Data > Streams with the Synced status. Synchronization runs at the configured frequency.
Need help?
See the Troubleshooting page for connection errors or write to us: Support and contact.