HubSpot
Connect HubSpot to surface every workflow, AI-assistant suggestion, ChatSpot interaction, and installed third-party app operating in your portal. The OAuth connector polls the HubSpot API on a 15-minute cadence and records each workflow + integration as an observed agent.
What gets observed
- Workflows (enrolment activity + last-run timestamps + branch paths taken).
- AI content-assistant + ChatSpot usage (per-user counts via the audit-log API).
- Installed third-party apps (with their scopes and last activity).
- Account-level audit events (user role changes, app installs, API-key minting).
- Sequence + meeting-link automations.
For per-prompt fidelity on AI Content Assistant calls, route outbound traffic through the collector LLM proxy. The HubSpot OAuth surface itself only exposes activity envelopes.
Setup
- Sign in to app.trefur.com as a HubSpot Super Admin.
- Open Integrations → HubSpot → Connect.
- Approve the consent screen at HubSpot. [Screenshot: HubSpot OAuth consent screen]
- On success Trefur kicks off an instant scan. Initial inventory completes in 30-90 seconds depending on portal size.
OAuth scopes requested
| Scope | What it grants |
|---|---|
automation | Read access to workflows and automation. |
crm.objects.contacts.read | Read contact records. |
Troubleshooting
| Symptom | Fix |
|---|---|
| Audit-log events missing. | HubSpot security audit events require a Pro or Enterprise subscription. On Starter portals the connector still inventories workflows + apps without audit events. |
| Connect button greyed out. | HubSpot OAuth requires Super Admin role. Confirm your HubSpot user has it under Settings → Users & Teams. |
| Workflow shows 0 enrolments after scan. | Workflows are listed even when dormant. The 24-hour roll-up populates the next morning UTC. |
Back to all integrations.