Key Features
- Incremental synchronization: the connector tracks each object’s
hs_lastmodifieddatecursor across runs and only delivers new or updated records. - Selectable CRM objects: choose which objects to ingest (e.g.
contacts,companies,deals); standard and custom objects are discovered automatically. - Scheduled ingestion: flexible scheduling by minutes, hours, or days, with an immediate first run on creation.
Prerequisites
- A HubSpot account with permission to create private apps.
- A private app access token: in HubSpot, go to Settings → Integrations → Private apps, create a private app, grant it read scopes for the CRM objects you want to ingest (e.g.
crm.objects.contacts.read,crm.objects.companies.read,crm.objects.deals.read), and copy the access token.
Configuration
| Field | Required | Description |
|---|---|---|
| Access Token | Yes | The private app access token |
| Schedule | Yes | Sync frequency — see Scheduling |
Scheduling
API source connectors run on a schedule rather than streaming continuously. A first run is always triggered immediately after the connector is created; subsequent runs depend on the selected mode:| Mode | Behavior | Example |
|---|---|---|
| days | Runs every N days at 00:00 UTC + offset (in minutes) | Offset 30 → every day at 00:30 UTC |
| hours | Runs every N hours at :00 + offset (in minutes) | Offset 15 → 00:15, 01:15, 02:15, … |
| minutes | Runs every N minutes, anchored on the connector creation time | Created 10:03, interval 10 → 10:13, 10:23, … |