Skip to main content
A connected HubSpot portal gives your agents live tools for the portal: look up the caller, read their deals and companies, and create tasks and notes. Tools run during a conversation or before and after it, and no contact sync is required.

​
Available tools

These tools appear in your agent’s function menu once the portal is connected. See use integration tools in an agent for how to add and configure them.
Log Call Activity is the per-call, agent-driven version of activity logging: the agent decides when to log and what summary to write. Log activities automatically in the sync settings logs every conversation with a synced contact without the agent doing anything. Use one or the other, or both if you want automatic logs plus richer agent-written ones.

​
Required scopes

Each tool works only if the private app holds its scope, granted in Step 2 of connecting: HubSpot authorizes the task, note, and call engagement endpoints through the contact scopes, so there’s no separate engagement scope to grant. A missing scope doesn’t flag the connection, because HubSpot answers with a 403 rather than rejecting the credentials. The error body names the missing scope (category MISSING_SCOPES); granting it under Edit app fixes the tool without reconnecting.

​
FAQ

No. Tools work as soon as the connection is made, and each tool is bound to the specific connection you pick when configuring it. Contact sync, analysis mapping, and automatic activity logging are separate features you opt into.

​
Next steps

Integration tools for prompt agents

Add HubSpot tools to a single- or multi-prompt agent and test them with live requests.

Integration tools in conversation flow

Call HubSpot tools from a function node and branch on the result.

HubSpot contact sync

Import your HubSpot contacts, write analysis results back, and log calls and chats to the timeline.

Dynamic variables

Map tool responses to variables your agent can use later in the conversation.