Let agents work with HubSpot contacts, companies, deals, and tickets. Connect with OAuth, and the gateway injects tokens so agents never see them.
Overview
OneCLI connects AI agents to HubSpot through OAuth. Agents can read and manage CRM records including contacts, companies, deals, and tickets. The gateway injects OAuth credentials into requests to the HubSpot API automatically.
On self-hosted OneCLI, HubSpot needs your own HubSpot app first. See Self-hosted.
What you will set up
A HubSpot connection through OAuth, with read access by default and optional write scopes
Automatic token injection on HubSpot API requests
Per-agent, per-tool access to CRM records
Setup
1
Open the app
Open the OneCLI dashboard and navigate to Settings > Apps > HubSpot.
2
Authorize
Click Connect HubSpot. You’ll be redirected to HubSpot to authorize OneCLI. Review the requested permissions and click Grant access.
The HubSpot connect window on OneCLI Cloud.
OneCLI requests read access to contacts, companies, deals, owners, and tickets by default. Write access and additional scopes (line items, quotes, lists, schemas) are optional.
3
Verify
After authorization, you’ll be redirected back to the dashboard. The connection will show as Connected with your HubSpot portal domain.
Self-hosted: use your own HubSpot app
Skip this section on OneCLI Cloud. It’s only for self-hosted OneCLI without HUBSPOT_CLIENT_ID and HUBSPOT_CLIENT_SECRET set, or if you want your own company name on HubSpot’s consent screen.
1. Create the HubSpot app
Sign in to a HubSpot developer account (free). Open Apps > Create app, name it OneCLI, and open the Auth tab.
2. Add the scopes
Under Scopes, add these as Required:crm.objects.contacts.read, crm.objects.companies.read, crm.objects.deals.read, crm.objects.owners.read, tickets
The required scopes in HubSpot. HubSpot adds oauth on its own.
Add these as Optional, so agents can get write access when you grant it:crm.objects.contacts.write, crm.objects.companies.write, crm.objects.deals.write, crm.objects.line_items.read, crm.objects.quotes.read, crm.lists.read, crm.schemas.contacts.read, crm.schemas.companies.read, crm.schemas.deals.read
3. Add the redirect URL
In OneCLI, open Settings > Apps > HubSpot > Custom credentials and copy the Redirect URI. In HubSpot, paste it into Redirect URLs on the Auth tab, and save.
The OneCLI Redirect URI in HubSpot's Redirect URLs.
Copy the Redirect URI from Custom credentials in OneCLI.
4. Connect with your app
On the Auth tab, copy the Client ID and Client secret. Paste both into Settings > Apps > HubSpot > Custom credentials, select Save credentials, then Connect and grant access in HubSpot.
What agents can do
Area
Description
Contacts
Read, create, and update contact records and properties
Companies
Read, create, and update company records
Deals
Read, create, and update deals and pipeline stages
Tickets
Read, create, and update support tickets
Owners
View record owners and assignments
Lists
View contact lists (read-only)
Quotes & Line Items
View quotes and line item records (read-only)
Schemas
View property definitions for contacts, companies, and deals
Use cases
CRM enrichment agents that update contact records with data from other sources
Sales pipeline agents that track deals and update stages
Support agents that create and triage tickets
Reporting agents that pull CRM data for analysis
Controlling access
Access is per agent: grant the connection to each agent that needs it, choosing per tool what runs freely, what needs human approval, and what stays blocked — a read-only agent is a single grant. Organization rules add guardrails on top, like rate limits and blanket blocks. Everything is checked before credential injection, so a blocked request never reaches the HubSpot API.
FAQ
Can I give an agent read-only HubSpot access?
Yes. OneCLI requests read access by default, and write scopes are optional. A read-only agent is also a single grant.
Does the agent see my HubSpot token?
No. The token stays in OneCLI, and the gateway adds it at the proxy. See How it works.
How do I reconnect HubSpot?
Open Settings > Apps > HubSpot and connect again. Agents with access use the new connection automatically.
{"docsConfig":{"theme":"mint","$schema":"https://mintlify.com/docs.json","name":"OneCLI","colors":{"primary":"#0b5530","light":"#93e3b4","dark":"#0b5530"},"logo":{"light":"https://mintcdn.com/onecli-sh-docs/JAdtzZwaqVLjjWOS/logo/logo-full-light.svg?fit=max\u0026auto=format\u0026n=JAdtzZwaqVLjjWOS\u0026q=85\u0026s=a7b56b71149ebb0a32928ed6ba02eb86","dark":"https://mintcdn.com/onecli-sh-docs/JAdtzZwaqVLjjWOS/logo/logo-full-dark.svg?fit=max\u0026auto=format\u0026n=JAdtzZwaqVLjjWOS\u0026q=85\u0026s=f7b8a1d875b5f3a99562759a2662ee50","href":"/"},"favicon":"https://mintcdn.com/onecli-sh-docs/GPAiKFgoDh_qYDvG/favicon.png?fit=max\u0026auto=format\u0026n=GPAiKFgoDh_qYDvG\u0026q=85\u0026s=23ea1545092b2fb0f321bbf04bc79764","appearance":{"default":"light"},"background":{"color":{"light":"#ebe6d4","dark":"#083f23"}},"navbar":{"links":[{"href":"https://github.com/onecli/onecli","label":"GitHub"},{"href":"https://onecli.sh","label":"Install"}]},"footer":{"socials":{"github":"https://github.com/onecli"}},"fonts":{"heading":{"family":"Overused Grotesk","weight":600,"source":"fonts/OverusedGroteskRoman-VF.woff2","format":"woff2"}},"contextual":{"options":["copy","view","chatgpt","claude","perplexity","mcp","cursor","vscode"],"display":"header"},"styling":{"latex":false},"navigation":{"global":{"anchors":[{"anchor":"GitHub","icon":"https://mintlify.s3.us-west-1.amazonaws.com/onecli-sh-docs/images/github.svg","href":"https://github.com/onecli"}]},"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"onecli-sh-docs","hasAudioNarration":false,"actualSubdomain":"onecli-sh-docs","customDomains":[],"gitSource":{"type":"github","owner":"onecli","repo":"onecli-docs","deployBranch":"main","contentDirectory":"","isPrivate":true,"mountPath":"","label":"","_id":"6afb23636b0360be0a1911b0"},"entitlements":{},"buildId":"6afb60e20c708e167fcc2d72","clientVersion":"0.0.4177","searchFilterCounts":[{"language":"default","tag":"API Reference","count":240},{"language":"default","tag":"Workspace","count":105},{"language":"default","tag":"Integrations","count":88},{"language":"default","tag":"All app connections","count":64},{"language":"default","tag":"Enterprise","count":57},{"language":"default","tag":"Organization","count":52},{"language":"default","tag":"Apps","count":29},{"language":"default","tag":"Channels","count":28},{"language":"default","tag":"Platform","count":21},{"language":"default","tag":"Guides","count":17}]},"assistantConfig":{"enableAskAiButton":false,"enableStarterQuestions":false,"enableContextualStarterQuestions":false,"enableAskAiSearchBar":true},"basePath":"/docs","hasChatPermissions":false,"hasWebMcpPermissions":false,"toggles":[{"name":"kill-isr","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-rbac-roles","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-mintlify-slack","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-integrations-settings","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"rbac-expansion","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-pr-grouping","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-prefix","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"analytics-v7","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"user-flows-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"no-publish-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-onboarding","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving-live","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"stripTemperatureMiddleware","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"support-platform-pylon-zendesk","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"instant-rollback","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications-server","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-fable","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fixed-ai-action-pricing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automation-resolve-merge-conflict","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"scoped-publishing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"mintql","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"page-level-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-version-history-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"billing-page-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"full-page-search","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workspace-projects","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"assistant-v5","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fork-pr-previews","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"revalidation-jwt","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-sso-scim","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"hobby-abuse-scan","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"dashboard-inbox","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-signup","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-dual-write","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-enabled","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"approve-review-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-metadata","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"sso-setup-deadline-banner","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-serve","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"live-agents","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"starter-pricing","enabled":true,"variant":{"name":"treatment","enabled":true,"payload":{"type":"string","value":"treatment"},"feature_enabled":true},"impressionData":false},{"name":"llms-txt-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false}],"googleFontsInlined":false},"customCss":[{"filePath":"style.css","content":"a.nav-anchor div.mr-4.rounded-md{--tw-ring-color: transparent !important;--tw-ring-shadow: 0 0 0 0 transparent !important;--tw-ring-offset-shadow: 0 0 0 0 transparent !important;box-shadow:none!important;background:transparent!important;filter:none!important;transition:opacity 0.15s ease!important}a.nav-anchor:hover div.mr-4.rounded-md{--tw-ring-color: transparent !important;--tw-ring-shadow: 0 0 0 0 transparent !important;--tw-ring-offset-shadow: 0 0 0 0 transparent !important;box-shadow:none!important;background:transparent!important;filter:none!important;opacity:0.7!important}a.nav-anchor div.mr-4.rounded-md img{opacity:1!important;filter:none!important;background:transparent!important}a.nav-anchor:hover div.mr-4.rounded-md img{opacity:1!important;filter:none!important;background:transparent!important}.dark a.nav-anchor div.mr-4.rounded-md img,[data-theme=\"dark\"] a.nav-anchor div.mr-4.rounded-md img{filter:invert(1)!important}html:not(.dark) .card,html:not(.dark) .code-block [data-component-part=\"code-block-root\"],html:not(.dark) .callout{background-color:#f3efe1!important}html:not(.dark) .card,html:not(.dark) .code-block{border-color:#cbc3a8!important}html:not(.dark) [data-component-part=\"step-indicator\"]>div,html:not(.dark) [data-component-part=\"step-indicator\"] .bg-gray-50{background-color:#d9d2ba!important;color:#0b5530!important}#theme-preference-menu-item-system,[data-theme-preference=\"system\"]{display:none!important}"}],"page":{"pagePath":"integrations/hubspot","slug":"/integrations/hubspot","pageMetadata":{"title":"Let AI Agents Update HubSpot CRM Records","sidebarTitle":"HubSpot","description":"Let agents work with HubSpot contacts, companies, deals, and tickets. Connect with OAuth, and the gateway injects tokens so agents never see them.","canonical":"https://onecli.sh/docs/integrations/hubspot","href":"/integrations/hubspot"},"description":{"compiledSource":"\"use strict\";\nconst {jsx: _jsx} = arguments[0];\nconst {useMDXComponents: _provideComponents} = arguments[0];\nfunction _createMdxContent(props) {\n const _components = {\n p: \"p\",\n ..._provideComponents(),\n ...props.components\n };\n return _jsx(_components.p, {\n children: \"Let agents work with HubSpot contacts, companies, deals, and tickets. Connect with OAuth, and the gateway injects tokens so agents never see them.\"\n });\n}\nfunction MDXContent(props = {}) {\n const {wrapper: MDXLayout} = {\n ..._provideComponents(),\n ...props.components\n };\n return MDXLayout ? _jsx(MDXLayout, {\n ...props,\n children: _jsx(_createMdxContent, {\n ...props\n })\n }) : _createMdxContent(props);\n}\nreturn {\n default: MDXContent\n};\n","frontmatter":{},"scope":{}},"pageType":"default","mdx":{"mdxSource":{"compiledSource":"\"use strict\";const{Fragment:_Fragment,jsx:_jsx,jsxs:_jsxs}=arguments[0];const{useMDXComponents:_provideComponents}=arguments[0];function _createMdxContent(props){const _components={a:`a`,code:`code`,li:`li`,p:`p`,strong:`strong`,tbody:`tbody`,td:`td`,th:`th`,thead:`thead`,tr:`tr`,ul:`ul`,..._provideComponents(),...props.components},{Accordion,AccordionGroup,Frame,Heading,Info,Note,OptimizedImage,Step,Steps,Table}=_components;if(!Accordion)_missingMdxReference(`Accordion`,true);if(!AccordionGroup)_missingMdxReference(`AccordionGroup`,true);if(!Frame)_missingMdxReference(`Frame`,true);if(!Heading)_missingMdxReference(`Heading`,true);if(!Info)_missingMdxReference(`Info`,true);if(!Note)_missingMdxReference(`Note`,true);if(!OptimizedImage)_missingMdxReference(`OptimizedImage`,true);if(!Step)_missingMdxReference(`Step`,true);if(!Steps)_missingMdxReference(`Steps`,true);if(!Table)_missingMdxReference(`Table`,true);return _jsxs(_Fragment,{children:[_jsx(Heading,{level:`2`,id:`overview`,children:`Overview`}),`\n`,_jsx(_components.p,{children:`OneCLI connects AI agents to HubSpot through OAuth. Agents can read and manage CRM records including contacts, companies, deals, and tickets. The gateway injects OAuth credentials into requests to the HubSpot API automatically.`}),`\n`,_jsx(Note,{children:_jsxs(_components.p,{children:[`On self-hosted OneCLI, HubSpot needs your own HubSpot app first. See `,_jsx(_components.a,{href:`#self-hosted`,children:`Self-hosted`}),`.`]})}),`\n`,_jsx(Heading,{level:`2`,id:`what-you-will-set-up`,children:`What you will set up`}),`\n`,_jsxs(_components.ul,{children:[`\n`,_jsx(_components.li,{children:`A HubSpot connection through OAuth, with read access by default and optional write scopes`}),`\n`,_jsx(_components.li,{children:`Automatic token injection on HubSpot API requests`}),`\n`,_jsx(_components.li,{children:`Per-agent, per-tool access to CRM records`}),`\n`]}),`\n`,_jsx(Heading,{level:`2`,id:`setup`,children:`Setup`}),`\n`,_jsxs(Steps,{children:[_jsx(Step,{title:`Open the app`,children:_jsxs(_components.p,{children:[`Open the OneCLI dashboard and navigate to `,_jsx(_components.strong,{children:`Settings`}),` > `,_jsx(_components.strong,{children:`Apps`}),` > `,_jsx(_components.strong,{children:`HubSpot`}),`.`]})}),_jsxs(Step,{title:`Authorize`,children:[_jsxs(_components.p,{children:[`Click `,_jsx(_components.strong,{children:`Connect HubSpot`}),`. You’ll be redirected to HubSpot to authorize OneCLI. Review the requested permissions and click `,_jsx(_components.strong,{children:`Grant access`}),`.`]}),_jsx(Frame,{caption:`The HubSpot connect window on OneCLI Cloud.`,children:_jsx(OptimizedImage,{src:`https://mintcdn.com/onecli-sh-docs/GPAiKFgoDh_qYDvG/images/integrations/hubspot/onecli-connect-hubspot.png?fit=max\u0026auto=format\u0026n=GPAiKFgoDh_qYDvG\u0026q=85\u0026s=0a3b0b207704ae7b65b33a707798988e`,alt:`OneCLI connect window for HubSpot on Cloud, showing the Connect to HubSpot button.`,\"data-og-width\":`976`,width:`976`,\"data-og-height\":`1078`,height:`1078`,\"data-path\":`images/integrations/hubspot/onecli-connect-hubspot.png`,\"data-optimize\":`true`,\"data-opv\":`3`,srcset:`https://mintcdn.com/onecli-sh-docs/GPAiKFgoDh_qYDvG/images/integrations/hubspot/onecli-connect-hubspot.png?w=280\u0026fit=max\u0026auto=format\u0026n=GPAiKFgoDh_qYDvG\u0026q=85\u0026s=b17818e9c743456c6d91d0f393100497 280w, https://mintcdn.com/onecli-sh-docs/GPAiKFgoDh_qYDvG/images/integrations/hubspot/onecli-connect-hubspot.png?w=560\u0026fit=max\u0026auto=format\u0026n=GPAiKFgoDh_qYDvG\u0026q=85\u0026s=7ccf08b28301a275db4205ab897a0a78 560w, https://mintcdn.com/onecli-sh-docs/GPAiKFgoDh_qYDvG/images/integrations/hubspot/onecli-connect-hubspot.png?w=840\u0026fit=max\u0026auto=format\u0026n=GPAiKFgoDh_qYDvG\u0026q=85\u0026s=051e79f6d7b4f15348288af0d3fbdaae 840w, https://mintcdn.com/onecli-sh-docs/GPAiKFgoDh_qYDvG/images/integrations/hubspot/onecli-connect-hubspot.png?w=1100\u0026fit=max\u0026auto=format\u0026n=GPAiKFgoDh_qYDvG\u0026q=85\u0026s=0d616e0eb434ee412f3bbee518c7b1b2 1100w, https://mintcdn.com/onecli-sh-docs/GPAiKFgoDh_qYDvG/images/integrations/hubspot/onecli-connect-hubspot.png?w=1650\u0026fit=max\u0026auto=format\u0026n=GPAiKFgoDh_qYDvG\u0026q=85\u0026s=be1dbc01c187936e49fd1490e2219696 1650w, https://mintcdn.com/onecli-sh-docs/GPAiKFgoDh_qYDvG/images/integrations/hubspot/onecli-connect-hubspot.png?w=2500\u0026fit=max\u0026auto=format\u0026n=GPAiKFgoDh_qYDvG\u0026q=85\u0026s=375902dacc5540bb36e6c0b37b37282e 2500w`})}),_jsx(_components.p,{children:`OneCLI requests read access to contacts, companies, deals, owners, and tickets by default. Write access and additional scopes (line items, quotes, lists, schemas) are optional.`})]}),_jsx(Step,{title:`Verify`,children:_jsxs(_components.p,{children:[`After authorization, you’ll be redirected back to the dashboard. The connection will show as `,_jsx(_components.strong,{children:`Connected`}),` with your HubSpot portal domain.`]})})]}),`\n`,_jsx(`a`,{id:`self-hosted`,style:{scrollMarginTop:`8rem`}}),`\n`,_jsx(Heading,{level:`2`,id:`self-hosted-use-your-own-hubspot-app`,children:`Self-hosted: use your own HubSpot app`}),`\n`,_jsx(Info,{children:_jsxs(_components.p,{children:[_jsx(_components.strong,{children:`Skip this section on OneCLI Cloud.`}),` It’s only for self-hosted OneCLI without `,_jsx(_components.code,{children:`HUBSPOT_CLIENT_ID`}),` and `,_jsx(_components.code,{children:`HUBSPOT_CLIENT_SECRET`}),` set, or if you want your own company name on HubSpot’s consent screen.`]})}),`\n`,_jsxs(AccordionGroup,{children:[_jsx(Accordion,{title:`1. Create the HubSpot app`,defaultOpen:true,id:`1-create-the-hubspot-app`,children:_jsxs(_components.p,{children:[`Sign in to a `,_jsx(_components.a,{href:`https://developers.hubspot.com/`,children:`HubSpot developer account`}),` (free). Open `,_jsx(_components.strong,{children:`Apps`}),` > `,_jsx(_components.strong,{children:`Create app`}),`, name it `,_jsx(_components.code,{children:`OneCLI`}),`, and open the `,_jsx(_components.strong,{children:`Auth`}),` tab.`]})}),_jsxs(Accordion,{title:`2. Add the scopes`,id:`2-add-the-scopes`,children:[_jsxs(_components.p,{children:[`Under `,_jsx(_components.strong,{children:`Scopes`}),`, add these as `,_jsx(_components.strong,{children:`Required`}),`:`]}),_jsxs(_components.p,{children:[_jsx(_components.code,{children:`crm.objects.contacts.read`}),`, `,_jsx(_components.code,{children:`crm.objects.companies.read`}),`, `,_jsx(_components.code,{children:`crm.objects.deals.read`}),`, `,_jsx(_components.code,{children:`crm.objects.owners.read`}),`, `,_jsx(_components.code,{children:`tickets`})]}),_jsx(Frame,{caption:`The required scopes in HubSpot. HubSpot adds oauth on its own.`,children:_jsx(OptimizedImage,{src:`https://mintcdn.com/onecli-sh-docs/GPAiKFgoDh_qYDvG/images/integrations/hubspot/01-scopes.png?fit=max\u0026auto=format\u0026n=GPAiKFgoDh_qYDvG\u0026q=85\u0026s=3ec74f872231bedc9457c48a600701bf`,alt:`HubSpot app Scopes section with six required scopes: crm.objects.contacts.read, crm.objects.companies.read, crm.objects.deals.read, crm.objects.owners.read, tickets, and oauth.`,\"data-og-width\":`1638`,width:`1638`,\"data-og-height\":`1046`,height:`1046`,\"data-path\":`images/integrations/hubspot/01-scopes.png`,\"data-optimize\":`true`,\"data-opv\":`3`,srcset:`https://mintcdn.com/onecli-sh-docs/GPAiKFgoDh_qYDvG/images/integrations/hubspot/01-scopes.png?w=280\u0026fit=max\u0026auto=format\u0026n=GPAiKFgoDh_qYDvG\u0026q=85\u0026s=23312f9aec180af89daeaa0cb53d16dd 280w, https://mintcdn.com/onecli-sh-docs/GPAiKFgoDh_qYDvG/images/integrations/hubspot/01-scopes.png?w=560\u0026fit=max\u0026auto=format\u0026n=GPAiKFgoDh_qYDvG\u0026q=85\u0026s=bb4dbea759537a278485e079707e4df5 560w, https://mintcdn.com/onecli-sh-docs/GPAiKFgoDh_qYDvG/images/integrations/hubspot/01-scopes.png?w=840\u0026fit=max\u0026auto=format\u0026n=GPAiKFgoDh_qYDvG\u0026q=85\u0026s=7131e4042311edb344c06d8c484e8b0d 840w, https://mintcdn.com/onecli-sh-docs/GPAiKFgoDh_qYDvG/images/integrations/hubspot/01-scopes.png?w=1100\u0026fit=max\u0026auto=format\u0026n=GPAiKFgoDh_qYDvG\u0026q=85\u0026s=7e689de9c3665b731b0f5011d4da6edb 1100w, https://mintcdn.com/onecli-sh-docs/GPAiKFgoDh_qYDvG/images/integrations/hubspot/01-scopes.png?w=1650\u0026fit=max\u0026auto=format\u0026n=GPAiKFgoDh_qYDvG\u0026q=85\u0026s=c049d62a969e9f0c4a977ec6c474810e 1650w, https://mintcdn.com/onecli-sh-docs/GPAiKFgoDh_qYDvG/images/integrations/hubspot/01-scopes.png?w=2500\u0026fit=max\u0026auto=format\u0026n=GPAiKFgoDh_qYDvG\u0026q=85\u0026s=6146c94950b2811940f310ff5c691f1a 2500w`})}),_jsxs(_components.p,{children:[`Add these as `,_jsx(_components.strong,{children:`Optional`}),`, so agents can get write access when you grant it:`]}),_jsxs(_components.p,{children:[_jsx(_components.code,{children:`crm.objects.contacts.write`}),`, `,_jsx(_components.code,{children:`crm.objects.companies.write`}),`, `,_jsx(_components.code,{children:`crm.objects.deals.write`}),`, `,_jsx(_components.code,{children:`crm.objects.line_items.read`}),`, `,_jsx(_components.code,{children:`crm.objects.quotes.read`}),`, `,_jsx(_components.code,{children:`crm.lists.read`}),`, `,_jsx(_components.code,{children:`crm.schemas.contacts.read`}),`, `,_jsx(_components.code,{children:`crm.schemas.companies.read`}),`, `,_jsx(_components.code,{children:`crm.schemas.deals.read`})]})]}),_jsxs(Accordion,{title:`3. Add the redirect URL`,id:`3-add-the-redirect-url`,children:[_jsxs(_components.p,{children:[`In OneCLI, open `,_jsx(_components.strong,{children:`Settings`}),` > `,_jsx(_components.strong,{children:`Apps`}),` > `,_jsx(_components.strong,{children:`HubSpot`}),` > `,_jsx(_components.strong,{children:`Custom credentials`}),` and copy the `,_jsx(_components.strong,{children:`Redirect URI`}),`. In HubSpot, paste it into `,_jsx(_components.strong,{children:`Redirect URLs`}),` on the `,_jsx(_components.strong,{children:`Auth`}),` tab, and save.`]}),_jsx(Frame,{caption:`The OneCLI Redirect URI in HubSpot's Redirect URLs.`,children:_jsx(OptimizedImage,{src:`https://mintcdn.com/onecli-sh-docs/GPAiKFgoDh_qYDvG/images/integrations/hubspot/02-redirect-url.png?fit=max\u0026auto=format\u0026n=GPAiKFgoDh_qYDvG\u0026q=85\u0026s=657ae0cefdad335812101b7a4ffc1110`,alt:`HubSpot Redirect URLs section with one entry: https://onecli.example.com/v1/apps/hubspot/callback.`,\"data-og-width\":`1644`,width:`1644`,\"data-og-height\":`498`,height:`498`,\"data-path\":`images/integrations/hubspot/02-redirect-url.png`,\"data-optimize\":`true`,\"data-opv\":`3`,srcset:`https://mintcdn.com/onecli-sh-docs/GPAiKFgoDh_qYDvG/images/integrations/hubspot/02-redirect-url.png?w=280\u0026fit=max\u0026auto=format\u0026n=GPAiKFgoDh_qYDvG\u0026q=85\u0026s=7fbcd98c64278d66a4b1a5a22d1da27e 280w, https://mintcdn.com/onecli-sh-docs/GPAiKFgoDh_qYDvG/images/integrations/hubspot/02-redirect-url.png?w=560\u0026fit=max\u0026auto=format\u0026n=GPAiKFgoDh_qYDvG\u0026q=85\u0026s=044c0e5eb6ed981888e32c27adc3239c 560w, https://mintcdn.com/onecli-sh-docs/GPAiKFgoDh_qYDvG/images/integrations/hubspot/02-redirect-url.png?w=840\u0026fit=max\u0026auto=format\u0026n=GPAiKFgoDh_qYDvG\u0026q=85\u0026s=661af25db8c7202cf4eac82ce7eeaabf 840w, https://mintcdn.com/onecli-sh-docs/GPAiKFgoDh_qYDvG/images/integrations/hubspot/02-redirect-url.png?w=1100\u0026fit=max\u0026auto=format\u0026n=GPAiKFgoDh_qYDvG\u0026q=85\u0026s=8930d898ca5d1bb3276b07e5fb4d9a72 1100w, https://mintcdn.com/onecli-sh-docs/GPAiKFgoDh_qYDvG/images/integrations/hubspot/02-redirect-url.png?w=1650\u0026fit=max\u0026auto=format\u0026n=GPAiKFgoDh_qYDvG\u0026q=85\u0026s=89fbc444f9d50aaadd5fbab2748e48de 1650w, https://mintcdn.com/onecli-sh-docs/GPAiKFgoDh_qYDvG/images/integrations/hubspot/02-redirect-url.png?w=2500\u0026fit=max\u0026auto=format\u0026n=GPAiKFgoDh_qYDvG\u0026q=85\u0026s=e2aa9e49a937a8a47364bf75e1a3d9a2 2500w`})}),_jsx(Frame,{caption:`Copy the Redirect URI from Custom credentials in OneCLI.`,children:_jsx(OptimizedImage,{src:`https://mintcdn.com/onecli-sh-docs/GPAiKFgoDh_qYDvG/images/integrations/hubspot/onecli-custom-credentials-hubspot.png?fit=max\u0026auto=format\u0026n=GPAiKFgoDh_qYDvG\u0026q=85\u0026s=dc4e3456c539139e494792b9a61dd455`,alt:`OneCLI Custom credentials card for HubSpot with the setup guide link, the Redirect URI and its copy button, and the client ID and secret fields.`,\"data-og-width\":`1712`,width:`1712`,\"data-og-height\":`804`,height:`804`,\"data-path\":`images/integrations/hubspot/onecli-custom-credentials-hubspot.png`,\"data-optimize\":`true`,\"data-opv\":`3`,srcset:`https://mintcdn.com/onecli-sh-docs/GPAiKFgoDh_qYDvG/images/integrations/hubspot/onecli-custom-credentials-hubspot.png?w=280\u0026fit=max\u0026auto=format\u0026n=GPAiKFgoDh_qYDvG\u0026q=85\u0026s=6ab9cc7316819dbd8b6f01a522b7a643 280w, https://mintcdn.com/onecli-sh-docs/GPAiKFgoDh_qYDvG/images/integrations/hubspot/onecli-custom-credentials-hubspot.png?w=560\u0026fit=max\u0026auto=format\u0026n=GPAiKFgoDh_qYDvG\u0026q=85\u0026s=651036a1bc7d9376dcc5f86694d0d37b 560w, https://mintcdn.com/onecli-sh-docs/GPAiKFgoDh_qYDvG/images/integrations/hubspot/onecli-custom-credentials-hubspot.png?w=840\u0026fit=max\u0026auto=format\u0026n=GPAiKFgoDh_qYDvG\u0026q=85\u0026s=535ef506a8a547e7e10875392349be8e 840w, https://mintcdn.com/onecli-sh-docs/GPAiKFgoDh_qYDvG/images/integrations/hubspot/onecli-custom-credentials-hubspot.png?w=1100\u0026fit=max\u0026auto=format\u0026n=GPAiKFgoDh_qYDvG\u0026q=85\u0026s=cc063bec856b1b7e66878779c80b64b6 1100w, https://mintcdn.com/onecli-sh-docs/GPAiKFgoDh_qYDvG/images/integrations/hubspot/onecli-custom-credentials-hubspot.png?w=1650\u0026fit=max\u0026auto=format\u0026n=GPAiKFgoDh_qYDvG\u0026q=85\u0026s=313a12a859b56afd405212fc70655837 1650w, https://mintcdn.com/onecli-sh-docs/GPAiKFgoDh_qYDvG/images/integrations/hubspot/onecli-custom-credentials-hubspot.png?w=2500\u0026fit=max\u0026auto=format\u0026n=GPAiKFgoDh_qYDvG\u0026q=85\u0026s=18d5149701caabf1d5eb6eb740e561b4 2500w`})})]}),_jsx(Accordion,{title:`4. Connect with your app`,id:`4-connect-with-your-app`,children:_jsxs(_components.p,{children:[`On the `,_jsx(_components.strong,{children:`Auth`}),` tab, copy the `,_jsx(_components.strong,{children:`Client ID`}),` and `,_jsx(_components.strong,{children:`Client secret`}),`. Paste both into `,_jsx(_components.strong,{children:`Settings`}),` > `,_jsx(_components.strong,{children:`Apps`}),` > `,_jsx(_components.strong,{children:`HubSpot`}),` > `,_jsx(_components.strong,{children:`Custom credentials`}),`, select `,_jsx(_components.strong,{children:`Save credentials`}),`, then `,_jsx(_components.strong,{children:`Connect`}),` and grant access in HubSpot.`]})})]}),`\n`,_jsx(Heading,{level:`2`,id:`what-agents-can-do`,children:`What agents can do`}),`\n`,_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsx(_components.th,{children:`Area`}),_jsx(_components.th,{children:`Description`})]})}),_jsxs(_components.tbody,{children:[_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:`Contacts`})}),_jsx(_components.td,{children:`Read, create, and update contact records and properties`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:`Companies`})}),_jsx(_components.td,{children:`Read, create, and update company records`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:`Deals`})}),_jsx(_components.td,{children:`Read, create, and update deals and pipeline stages`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:`Tickets`})}),_jsx(_components.td,{children:`Read, create, and update support tickets`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:`Owners`})}),_jsx(_components.td,{children:`View record owners and assignments`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:`Lists`})}),_jsx(_components.td,{children:`View contact lists (read-only)`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:`Quotes \u0026 Line Items`})}),_jsx(_components.td,{children:`View quotes and line item records (read-only)`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:`Schemas`})}),_jsx(_components.td,{children:`View property definitions for contacts, companies, and deals`})]})]})]}),`\n`,_jsx(Heading,{level:`2`,id:`use-cases`,children:`Use cases`}),`\n`,_jsxs(_components.ul,{children:[`\n`,_jsx(_components.li,{children:`CRM enrichment agents that update contact records with data from other sources`}),`\n`,_jsx(_components.li,{children:`Sales pipeline agents that track deals and update stages`}),`\n`,_jsx(_components.li,{children:`Support agents that create and triage tickets`}),`\n`,_jsx(_components.li,{children:`Reporting agents that pull CRM data for analysis`}),`\n`]}),`\n`,_jsx(Heading,{level:`2`,id:`controlling-access`,children:`Controlling access`}),`\n`,_jsxs(_components.p,{children:[`Access is per agent: `,_jsx(_components.a,{href:`/guides/agent-access`,children:`grant`}),` the connection to each agent that needs it, choosing per tool what runs freely, what needs human approval, and what stays blocked — a read-only agent is a single grant. Organization `,_jsx(_components.a,{href:`/guides/rules`,children:`rules`}),` add guardrails on top, like rate limits and blanket blocks. Everything is checked before credential injection, so a blocked request never reaches the HubSpot API.`]}),`\n`,_jsx(Heading,{level:`2`,id:`faq`,children:`FAQ`}),`\n`,_jsxs(AccordionGroup,{children:[_jsx(Accordion,{title:`Can I give an agent read-only HubSpot access?`,id:`can-i-give-an-agent-read-only-hubspot-access`,children:_jsxs(_components.p,{children:[`Yes. OneCLI requests read access by default, and write scopes are optional. A read-only agent is also a single `,_jsx(_components.a,{href:`/guides/agent-access`,children:`grant`}),`.`]})}),_jsx(Accordion,{title:`Does the agent see my HubSpot token?`,id:`does-the-agent-see-my-hubspot-token`,children:_jsxs(_components.p,{children:[`No. The token stays in OneCLI, and the gateway adds it at the proxy. See `,_jsx(_components.a,{href:`/how-it-works`,children:`How it works`}),`.`]})}),_jsx(Accordion,{title:`How do I reconnect HubSpot?`,id:`how-do-i-reconnect-hubspot`,children:_jsxs(_components.p,{children:[`Open `,_jsx(_components.strong,{children:`Settings`}),` > `,_jsx(_components.strong,{children:`Apps`}),` > `,_jsx(_components.strong,{children:`HubSpot`}),` and connect again. Agents with access use the new connection automatically.`]})})]})]})}function MDXContent(props={}){const{wrapper:MDXLayout}={..._provideComponents(),...props.components};return MDXLayout?_jsx(MDXLayout,{...props,children:_jsx(_createMdxContent,{...props})}):_createMdxContent(props)}return{default:MDXContent};function _missingMdxReference(id,component){throw new Error(`Expected `+(component?`component`:`object`)+\" `\"+id+\"` to be defined: you likely forgot to import, pass, or provide it.\")}","frontmatter":{},"scope":{"config":{},"pageMetadata":{"title":"Let AI Agents Update HubSpot CRM Records","sidebarTitle":"HubSpot","description":"Let agents work with HubSpot contacts, companies, deals, and tickets. Connect with OAuth, and the gateway injects tokens so agents never see them.","canonical":"https://onecli.sh/docs/integrations/hubspot","href":"/integrations/hubspot"}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[{"title":"Overview","slug":"overview","depth":2,"children":[]},{"title":"What you will set up","slug":"what-you-will-set-up","depth":2,"children":[]},{"title":"Setup","slug":"setup","depth":2,"children":[]},{"title":"Self-hosted: use your own HubSpot app","slug":"self-hosted-use-your-own-hubspot-app","depth":2,"children":[]},{"title":"What agents can do","slug":"what-agents-can-do","depth":2,"children":[]},{"title":"Use cases","slug":"use-cases","depth":2,"children":[]},{"title":"Controlling access","slug":"controlling-access","depth":2,"children":[]},{"title":"FAQ","slug":"faq","depth":2,"children":[]}],"codeExamples":{}},"jsLinks":["/docs/_mintlify/custom/onecli-sh-docs/e8c5fc0faf4d8de9/infra/cloudfront/docs-response-headers.js"],"subdomain":"onecli-sh-docs","siteName":"OneCLI","title":"Let AI Agents Update HubSpot CRM Records - OneCLI","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-11-16T15:49:48.825Z","originalFileLocation":"integrations/hubspot.mdx"},"headHtml":"\u003cscript data-mint-head>(function(){var d=document.documentElement,p=null;if(!p){try{p=localStorage.getItem(\"isDarkMode\")}catch(e){}if(p==='true')p='dark';else if(p==='false')p='light';if(p!=='light'\u0026\u0026p!=='dark'\u0026\u0026p!=='system')p=\"light\"}var r=p==='system'?(matchMedia(\"(prefers-color-scheme: dark)\").matches?'dark':'light'):p;d.classList.remove(r==='dark'?'light':'dark');d.classList.add(r);d.setAttribute(\"data-theme-preference\",p)})();\u003c/script>\u003cmeta data-mint-head name=\"description\" content=\"Let agents work with HubSpot contacts, companies, deals, and tickets. Connect with OAuth, and the gateway injects tokens so agents never see them.\">\u003cmeta data-mint-head name=\"application-name\" content=\"OneCLI\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/docs/mintlify-assets/_mintlify/favicons/onecli-sh-docs/JyF-6zlco6U5Y4rW/_generated/favicon/android-chrome-192x192.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"apple-touch-icon\" type=\"image/png\" sizes=\"180x180\" href=\"/docs/mintlify-assets/_mintlify/favicons/onecli-sh-docs/JyF-6zlco6U5Y4rW/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/docs/mintlify-assets/_mintlify/favicons/onecli-sh-docs/JyF-6zlco6U5Y4rW/_generated/favicon/favicon-16x16.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/docs/mintlify-assets/_mintlify/favicons/onecli-sh-docs/JyF-6zlco6U5Y4rW/_generated/favicon/favicon-32x32.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/docs/mintlify-assets/_mintlify/favicons/onecli-sh-docs/JyF-6zlco6U5Y4rW/_generated/favicon/favicon.ico\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/docs/mintlify-assets/_mintlify/favicons/onecli-sh-docs/JyF-6zlco6U5Y4rW/_generated/favicon-dark/android-chrome-192x192.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/docs/mintlify-assets/_mintlify/favicons/onecli-sh-docs/JyF-6zlco6U5Y4rW/_generated/favicon-dark/favicon-16x16.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/docs/mintlify-assets/_mintlify/favicons/onecli-sh-docs/JyF-6zlco6U5Y4rW/_generated/favicon-dark/favicon-32x32.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/docs/mintlify-assets/_mintlify/favicons/onecli-sh-docs/JyF-6zlco6U5Y4rW/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"Let AI Agents Update HubSpot CRM Records - OneCLI\">\u003cmeta data-mint-head property=\"og:description\" content=\"Let agents work with HubSpot contacts, companies, deals, and tickets. Connect with OAuth, and the gateway injects tokens so agents never see them.\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"OneCLI\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://onecli.sh/docs/integrations/hubspot\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://onecli-sh-docs.mintlify.site/docs/_mintlify/api/og/v2?division=Cloud+integrations\u0026amp;title=Let+AI+Agents+Update+HubSpot+CRM+Records\u0026amp;description=Let+agents+work+with+HubSpot+contacts%2C+companies%2C+deals%2C+and+tickets.+Connect+with+OAuth%2C+and+the+gateway+injects+tokens+so+agents+never+see+them.\u0026amp;theme=21276d7bc2dc55570cc64194\u0026amp;signature=6b627d673ddec94704fc837cc7234632411639b4a593078a87c3fc2cdc2acd2e\">\u003cmeta data-mint-head property=\"og:image:width\" content=\"1200\">\u003cmeta data-mint-head property=\"og:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"twitter:card\" content=\"summary_large_image\">\u003cmeta data-mint-head name=\"twitter:title\" content=\"Let AI Agents Update HubSpot CRM Records - OneCLI\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Let agents work with HubSpot contacts, companies, deals, and tickets. Connect with OAuth, and the gateway injects tokens so agents never see them.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://onecli-sh-docs.mintlify.site/docs/_mintlify/api/og/v2?division=Cloud+integrations\u0026amp;title=Let+AI+Agents+Update+HubSpot+CRM+Records\u0026amp;description=Let+agents+work+with+HubSpot+contacts%2C+companies%2C+deals%2C+and+tickets.+Connect+with+OAuth%2C+and+the+gateway+injects+tokens+so+agents+never+see+them.\u0026amp;theme=21276d7bc2dc55570cc64194\u0026amp;signature=6b627d673ddec94704fc837cc7234632411639b4a593078a87c3fc2cdc2acd2e\">\u003cmeta data-mint-head name=\"twitter:image:width\" content=\"1200\">\u003cmeta data-mint-head name=\"twitter:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"msapplication-config\" content=\"/docs/mintlify-assets/_mintlify/favicons/onecli-sh-docs/JyF-6zlco6U5Y4rW/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"OneCLI\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#0b5530\">\u003clink data-mint-head rel=\"canonical\" href=\"https://onecli.sh/docs/integrations/hubspot\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/docs/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/docs/integrations/hubspot.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://onecli-sh-docs.mintlify.dev/#organization\",\"name\":\"OneCLI\",\"url\":\"https://onecli-sh-docs.mintlify.dev\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/onecli-sh-docs/JAdtzZwaqVLjjWOS/logo/logo-full-light.svg?fit=max\u0026auto=format\u0026n=JAdtzZwaqVLjjWOS\u0026q=85\u0026s=a7b56b71149ebb0a32928ed6ba02eb86\"}},{\"@type\":\"WebSite\",\"@id\":\"https://onecli-sh-docs.mintlify.dev/docs#website\",\"name\":\"OneCLI\",\"url\":\"https://onecli-sh-docs.mintlify.dev/docs\",\"publisher\":{\"@id\":\"https://onecli-sh-docs.mintlify.dev/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://onecli.sh/docs/integrations/hubspot#webpage\",\"url\":\"https://onecli.sh/docs/integrations/hubspot\",\"name\":\"Let AI Agents Update HubSpot CRM Records\",\"description\":\"Let agents work with HubSpot contacts, companies, deals, and tickets. Connect with OAuth, and the gateway injects tokens so agents never see them.\",\"dateModified\":\"2026-11-16T15:49:48.825Z\",\"isPartOf\":{\"@id\":\"https://onecli-sh-docs.mintlify.dev/docs#website\"},\"breadcrumb\":{\"@id\":\"https://onecli.sh/docs/integrations/hubspot#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://onecli.sh/docs/integrations/hubspot#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Cloud integrations\",\"item\":\"https://onecli-sh-docs.mintlify.dev/docs/integrations/apollo-io\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Let AI Agents Update HubSpot CRM Records\",\"item\":\"https://onecli.sh/docs/integrations/hubspot\"}]},{\"@type\":[\"Article\",\"TechArticle\"],\"@id\":\"https://onecli.sh/docs/integrations/hubspot#article\",\"headline\":\"Let AI Agents Update HubSpot CRM Records\",\"name\":\"Let AI Agents Update HubSpot CRM Records\",\"description\":\"Let agents work with HubSpot contacts, companies, deals, and tickets. Connect with OAuth, and the gateway injects tokens so agents never see them.\",\"url\":\"https://onecli.sh/docs/integrations/hubspot\",\"mainEntityOfPage\":{\"@id\":\"https://onecli.sh/docs/integrations/hubspot#webpage\"},\"dateModified\":\"2026-11-16T15:49:48.825Z\",\"publisher\":{\"@id\":\"https://onecli-sh-docs.mintlify.dev/#organization\"},\"isPartOf\":{\"@id\":\"https://onecli-sh-docs.mintlify.dev/docs#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"OneCLI\",\"publisher\":{\"@type\":\"Organization\",\"name\":\"OneCLI\"},\"provider\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","agentPointerHref":"/docs/integrations/hubspot.md","siteName":"OneCLI","nav":{"global":{"anchors":[{"anchor":"GitHub","icon":"https://mintlify.s3.us-west-1.amazonaws.com/onecli-sh-docs/images/github.svg","href":"https://github.com/onecli"}]},"tabs":[{"tab":"Documentation","pages":[{"title":"Documentation","href":""}]},{"tab":"Integrations","groups":[{"group":"Integrations","root":{"title":"Integrations: Connect Agents to External Services","sidebarTitle":"Overview","href":"/integrations"},"pages":[{"title":"App Connections: How OAuth \u0026 API Keys Work","sidebarTitle":"App Connections","href":"/integrations/app-connections"},{"title":"Custom Connections: Connect Any API With a Key","sidebarTitle":"Custom connections","href":"/integrations/custom-connections"},{"title":"Chat With AI Agents and Approve Actions in Slack","sidebarTitle":"Slack","href":"/integrations/slack"},{"title":"Keep LLM API Keys Out of Your AI Agents","sidebarTitle":"LLMs","href":"/integrations/llms"},{"title":"External Vaults: Connect Password Managers","sidebarTitle":"External Vaults","href":"/vaults/overview"}]},{"group":"Cloud integrations","pages":[{"title":"Prospect and Enrich Leads in Apollo.io With Agents","sidebarTitle":"Apollo.io","href":"/integrations/apollo-io"},{"title":"Use AWS From AI Agents Without Exposing Keys","sidebarTitle":"AWS","href":"/integrations/aws"},{"title":"Let AI Agents Open PRs and Issues on GitHub","sidebarTitle":"GitHub","href":"/integrations/github"},{"title":"Org-Approved GitHub Repo Access for AI Agents","sidebarTitle":"GitHub App","href":"/integrations/github-app"},{"title":"Let AI Agents Query Datadog Metrics and Monitors","sidebarTitle":"Datadog","description":"Let on-call agents query Datadog metrics, check monitors, and read incidents. The gateway injects your API and application keys so agents never see them.","href":"/integrations/datadog"},{"title":"Let AI Agents Update HubSpot CRM Records","sidebarTitle":"HubSpot","href":"/integrations/hubspot"},{"title":"Let AI Agents Triage Sentry Errors","sidebarTitle":"Sentry","description":"Let agents read Sentry error events, triage and resolve issues, and track releases. Connect with OAuth, and the gateway keeps tokens out of the agent.","href":"/integrations/sentry"},{"title":"Let AI Agents Read and Write OneNote Notebooks","sidebarTitle":"Microsoft OneNote","href":"/integrations/microsoft-onenote"},{"title":"Connect AI Agents to Outlook Mail in Microsoft 365","sidebarTitle":"Outlook Mail","href":"/integrations/outlook-mail"},{"title":"Let AI Agents Book Meetings in Outlook Calendar","sidebarTitle":"Outlook Calendar","href":"/integrations/outlook-calendar"}]},{"group":"All app connections","pages":[{"title":"Connect AI Agents to Affinity CRM With an API Key","sidebarTitle":"Affinity","href":"/integrations/affinity"},{"title":"Let AI Agents Manage Attio CRM Records","sidebarTitle":"Attio","href":"/integrations/attio"},{"title":"Run Clay Enrichment From AI Agents","sidebarTitle":"Clay","href":"/integrations/clay"},{"title":"Query PostHog Analytics and Flags From Agents","sidebarTitle":"PostHog","href":"/integrations/posthog"},{"title":"Connect AI Agents to Salesforce With an External App","sidebarTitle":"Salesforce","href":"/integrations/salesforce"},{"title":"Turn Timeless Meetings Into Agent Follow-Ups","sidebarTitle":"Timeless","href":"/integrations/timeless"},{"title":"Let Agents Search Circleback Meeting Notes","sidebarTitle":"Circleback","href":"/integrations/circleback"},{"title":"Run HeyReach LinkedIn Campaigns From AI Agents","sidebarTitle":"HeyReach","href":"/integrations/heyreach"},{"title":"Automate Dripify LinkedIn Outreach With Agents","sidebarTitle":"Dripify","href":"/integrations/dripify"},{"title":"Let On-Call Agents Triage PagerDuty Incidents","sidebarTitle":"PagerDuty","href":"/integrations/pagerduty"},{"title":"Query Coralogix Logs and Metrics From Agents","sidebarTitle":"Coralogix","href":"/integrations/coralogix"},{"title":"Search Company Knowledge in Onyx From Agents","sidebarTitle":"Onyx","href":"/integrations/onyx"},{"title":"Scoped Cloudflare API Tokens for AI Agents","sidebarTitle":"Cloudflare","href":"/integrations/cloudflare"},{"title":"Set Up One Google OAuth Client for All Google Apps","sidebarTitle":"Google (setup)","href":"/integrations/google"},{"title":"Let AI Agents Search, Draft, and Send Gmail","sidebarTitle":"Gmail","href":"/integrations/gmail"},{"title":"Let AI Agents Schedule Meetings in Google Calendar","sidebarTitle":"Google Calendar","href":"/integrations/google-calendar"},{"title":"Give AI Agents Access to Google Drive Files","sidebarTitle":"Google Drive","href":"/integrations/google-drive"},{"title":"Let AI Agents Draft and Edit Google Docs","sidebarTitle":"Google Docs","href":"/integrations/google-docs"},{"title":"Let AI Agents Read and Update Google Sheets","sidebarTitle":"Google Sheets","href":"/integrations/google-sheets"},{"title":"Generate Google Slides Decks With AI Agents","sidebarTitle":"Google Slides","href":"/integrations/google-slides"},{"title":"Build Google Forms and Read Responses With Agents","sidebarTitle":"Google Forms","href":"/integrations/google-forms"},{"title":"Create Google Meet Links From AI Agents","sidebarTitle":"Google Meet","href":"/integrations/google-meet"},{"title":"Search and Organize Google Photos With AI Agents","sidebarTitle":"Google Photos","href":"/integrations/google-photos"},{"title":"Track To-Dos in Google Tasks From AI Agents","sidebarTitle":"Google Tasks","href":"/integrations/google-tasks"},{"title":"Automate Google Workspace User Admin With Agents","sidebarTitle":"Google Admin","href":"/integrations/google-admin"},{"title":"Pull GA4 Reports Into AI Agents","sidebarTitle":"Google Analytics","href":"/integrations/google-analytics"},{"title":"Let AI Agents Check Indexing in Search Console","sidebarTitle":"Google Search Console","href":"/integrations/google-search-console"},{"title":"Automate Google Classroom Coursework With Agents","sidebarTitle":"Google Classroom","href":"/integrations/google-classroom"},{"title":"Manage YouTube Playlists and Analytics With Agents","sidebarTitle":"YouTube","href":"/integrations/youtube"},{"title":"Let AI Agents Search and Update Notion Pages","sidebarTitle":"Notion","href":"/integrations/notion"},{"title":"Let AI Agents Create and Triage Jira Issues","sidebarTitle":"Jira","href":"/integrations/jira"},{"title":"Give AI Agents Search and Edit Access to Confluence","sidebarTitle":"Confluence","href":"/integrations/confluence"},{"title":"Let AI Agents Manage Your Todoist Tasks","sidebarTitle":"Todoist","href":"/integrations/todoist"},{"title":"Give AI Agents Safe Access to Your Dropbox Files","sidebarTitle":"Dropbox","href":"/integrations/dropbox"},{"title":"Deploy to Fly.io From an Agent Without Exposing Tokens","sidebarTitle":"Fly.io","href":"/integrations/flyio"},{"title":"Let AI Agents Post to LinkedIn on Your Behalf","sidebarTitle":"LinkedIn","href":"/integrations/linkedin"},{"title":"Connect AI Agents to Monday.com Boards","sidebarTitle":"Monday.com","href":"/integrations/monday"},{"title":"Administer MongoDB Atlas Clusters With Agents","sidebarTitle":"MongoDB Atlas","href":"/integrations/mongodb-atlas"},{"title":"Sync Navan Bookings and Expenses With AI Agents","sidebarTitle":"Navan","href":"/integrations/navan"},{"title":"Let AI Agents Send Email With Resend","sidebarTitle":"Resend","href":"/integrations/resend"},{"title":"Send SMS and WhatsApp From AI Agents With Twilio","sidebarTitle":"Twilio","href":"/integrations/twilio"},{"title":"Zendesk Integration: Tickets and Help Center","sidebarTitle":"Zendesk","href":"/integrations/zendesk"},{"title":"Manage Supabase Projects With AI Agents","sidebarTitle":"Supabase","href":"/integrations/supabase"},{"title":"Call Claude and Gemini on Vertex AI From Agents","sidebarTitle":"Vertex AI","href":"/integrations/vertex-ai"},{"title":"Let AI Agents Edit Webflow CMS and Publish Sites","sidebarTitle":"Webflow","href":"/integrations/webflow"},{"title":"Let AI Agents Schedule Zoom Meetings and Get Recordings","sidebarTitle":"Zoom","href":"/integrations/zoom"},{"title":"Give Agents AWS Access With an IAM Role, Not Keys","sidebarTitle":"AWS Role","href":"/integrations/aws-role"},{"title":"Bitbucket Repos, Pull Requests, and Pipelines","sidebarTitle":"Bitbucket","href":"/integrations/bitbucket"},{"title":"Manage Docker Hub Repositories From AI Agents","sidebarTitle":"Docker Hub","href":"/integrations/docker"},{"title":"Read Fathom Meeting Summaries From AI Agents","sidebarTitle":"Fathom","href":"/integrations/fathom"},{"title":"Give AI Agents Access to Fireflies Transcripts","sidebarTitle":"Fireflies","href":"/integrations/fireflies"},{"title":"Let AI Agents Work With GitLab Merge Requests","sidebarTitle":"GitLab","href":"/integrations/gitlab"},{"title":"Send Google Chat Messages From AI Agents","sidebarTitle":"Google Chat","href":"/integrations/google-chat"},{"title":"Let AI Agents Look Up and Update Google Contacts","sidebarTitle":"Google Contacts","href":"/integrations/google-contacts"},{"title":"Let AI Agents Read Your Granola Meeting Notes","sidebarTitle":"Granola","href":"/integrations/granola"},{"title":"Route Agent Package Installs Through JFrog","sidebarTitle":"JFrog Artifactory","href":"/integrations/jfrog-artifactory"},{"title":"Let AI Agents File and Update Linear Issues","sidebarTitle":"Linear","href":"/integrations/linear"},{"title":"Run Snowflake SQL From an Agent, Token Hidden","sidebarTitle":"Snowflake","href":"/integrations/snowflake"},{"title":"Use a Restricted Stripe Key With AI Agents","sidebarTitle":"Stripe","href":"/integrations/stripe"},{"title":"Let AI Agents Manage Trello Boards and Cards","sidebarTitle":"Trello","href":"/integrations/trello"},{"title":"Let AI Agents Deploy and Manage Vercel Projects","sidebarTitle":"Vercel","href":"/integrations/vercel"},{"title":"Let AI Agents Post and Read on X (Twitter)","sidebarTitle":"X","href":"/integrations/x"},{"title":"Let AI Agents Work Zoho CRM Leads and Deals","sidebarTitle":"Zoho CRM","href":"/integrations/zoho-crm"},{"title":"Let AI Agents Draft Word Docs in OneDrive","sidebarTitle":"Microsoft Word","href":"/integrations/microsoft-word"}]},{"group":"LLMs","pages":[{"title":"Connect Claude to Agents With a Token or API Key","sidebarTitle":"Anthropic","href":"/integrations/anthropic"},{"title":"Use OpenAI API Keys and Codex OAuth With AI Agents","sidebarTitle":"OpenAI","href":"/integrations/openai"}]},{"group":"External Vaults","pages":[{"title":"Bitwarden Vault: Sync Secrets to the Gateway","sidebarTitle":"Bitwarden","href":"/vaults/bitwarden"},{"title":"1Password Vault: Service Account Integration","sidebarTitle":"1Password","href":"/vaults/1password"}]}]},{"tab":"Guides","pages":[{"title":"Guides","href":"/guides"}]},{"tab":"API Reference","pages":[{"title":"API Reference","href":"/api-reference"}]},{"tab":"SDKs","pages":[{"title":"SDKs","href":"/sdks"}]}]},"basePath":"","title":"Let AI Agents Update HubSpot CRM Records - OneCLI","deploymentId":"dpl_81ettUQ5G7NASN425B6JKU3FX1Rg","buildId":"dpl_81ettUQ5G7NASN425B6JKU3FX1Rg","dynamics":["07c022d89b","a74be98ba7"],"chunks":["Frame-C6xGbawq.js","DynamicMarkdown-C_R66tyH.js","zoom-image-lightbox-Cr7fyDws.js","lightbox-handle-r17bVUz3.js"]}