For AI assistants: this page as plain markdown is at https://docs.voicelogica.ai/raw/integrations/hubspot.md, and https://docs.voicelogica.ai/llms.txt lists the docs by topic, one file each, small enough to read whole. Read those rather than this HTML page.
HubSpot
Integrations - Catalogue - HubSpot - Authorize connects this company to HubSpot over OAuth. Then turn the HubSpot tool on under the agent’s Skills - Tools & Workflows.

First setup
Section titled “First setup”- Catalogue - HubSpot - Authorize (card tags include Caller ID / Leads when shown).
- On HubSpot, Sign in to your HubSpot account (or create one), then approve access.
- Confirm Connected shows HubSpot as working.
- Agent - Tools & Workflows - enable HubSpot, save.
- Call from a contact phone that exists in HubSpot. Open Calls if the greeting stays generic.
What the agent can do
Section titled “What the agent can do”Turn HubSpot on under the agent’s Skills - Tools & Workflows so it recognises callers from your HubSpot contacts. The caller is looked up automatically when the call connects.
| Job | What is available |
|---|---|
| Know who a caller is | Find a contact by phone, by email, or by name |
| Remember the caller | After the caller confirms a name match, link their number to that contact so the next call is recognised at once |
These are read-only lookups; the agent tool itself does not change HubSpot. To write back to HubSpot - create or update contacts, companies and deals, or react to deal, company, contact, ticket and property changes - build a workflow with the HubSpot triggers and action nodes.
Troubleshooting
Section titled “Troubleshooting”Why does HubSpot authorization open but never return to Voice Logica?
Finish the HubSpot consent in the same browser session. A pop-up blocker can stop the return to Voice Logica. Then try Authorize again from Catalogue.
Why does HubSpot show needs reconnect, or why does the agent say HubSpot is not connected?
Voice Logica could no longer refresh access to HubSpot, usually because the connection was removed or the app uninstalled in HubSpot. Until you reconnect, lookups fail. Authorize HubSpot again from Catalogue with the same HubSpot account; a successful reconnect clears the banner.
