Let agents work with HubSpot contacts, companies, deals, and tickets. Connect with OAuth, and the gateway injects tokens so agents never see them.
Overview
Buckle 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 Buckle, 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 Buckle dashboard and navigate to Settings > Apps > HubSpot.
2
Authorize
Click Connect HubSpot. You’ll be redirected to HubSpot to authorize Buckle. Review the requested permissions and click Grant access.
The HubSpot connect window on Buckle Cloud.
Buckle 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 Buckle Cloud. It’s only for self-hosted Buckle 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 Buckle, 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 Buckle, 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 Buckle Redirect URI in HubSpot's Redirect URLs.
Copy the Redirect URI from Custom credentials in Buckle.
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. Buckle 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 Buckle, 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":"Buckle","colors":{"primary":"#ff6a13","light":"#ff8236","dark":"#e55e0f"},"logo":{"light":"https://mintcdn.com/onecli-17d3f772/5_AFCR2UNaqNo0AT/logo/logo-full-light.svg?fit=max\u0026auto=format\u0026n=5_AFCR2UNaqNo0AT\u0026q=85\u0026s=30ceea1dd3505e0e9dea50b544521ced","dark":"https://mintcdn.com/onecli-17d3f772/5_AFCR2UNaqNo0AT/logo/logo-full-dark.svg?fit=max\u0026auto=format\u0026n=5_AFCR2UNaqNo0AT\u0026q=85\u0026s=120ef96cf376422549781454d97dd810","href":"https://buckle.dev"},"favicon":"https://mintcdn.com/onecli-17d3f772/hJP3XqgFsBDnXHKy/favicon.svg?fit=max\u0026auto=format\u0026n=hJP3XqgFsBDnXHKy\u0026q=85\u0026s=ddda982106e5fd52c3815a54c183f4b1","appearance":{"default":"light"},"background":{"color":{"light":"#FAFAF9","dark":"#1A1918"}},"navbar":{"links":[{"href":"https://github.com/trybuckle/buckle","label":"GitHub"},{"href":"https://buckle.dev","label":"Install"}]},"footer":{"socials":{"github":"https://github.com/trybuckle"}},"fonts":{"heading":{"family":"Chakra Petch","weight":700,"source":"fonts/ChakraPetch-700.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-17d3f772/images/github.svg","href":"https://github.com/buckle"}]},"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"onecli-17d3f772","hasAudioNarration":false,"actualSubdomain":"onecli-17d3f772","customDomains":[],"gitSource":{"type":"github","owner":"trybuckle","repo":"buckle-docs","deployBranch":"main","contentDirectory":"","isPrivate":true,"mountPath":"","label":"","_id":"6af9ac749033d7e87e8c505a"},"entitlements":{"AI_CHAT":{"status":"DISABLED"}},"buildId":"6af9b4b9e79e0e5d703531fb","clientVersion":"0.0.4143","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":"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}"}],"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://buckle.dev/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:`Buckle 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 Buckle, 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 Buckle 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 Buckle. Review the requested permissions and click `,_jsx(_components.strong,{children:`Grant access`}),`.`]}),_jsx(Frame,{caption:`The HubSpot connect window on Buckle Cloud.`,children:_jsx(OptimizedImage,{src:`https://mintcdn.com/onecli-17d3f772/hJP3XqgFsBDnXHKy/images/integrations/hubspot/buckle-connect-hubspot.png?fit=max\u0026auto=format\u0026n=hJP3XqgFsBDnXHKy\u0026q=85\u0026s=1f138af35209859b1c355edbaaf60825`,alt:`Buckle connect window for HubSpot on Cloud, showing the Connect to HubSpot button.`,\"data-og-width\":`960`,width:`960`,\"data-og-height\":`1062`,height:`1062`,\"data-path\":`images/integrations/hubspot/buckle-connect-hubspot.png`,\"data-optimize\":`true`,\"data-opv\":`3`,srcset:`https://mintcdn.com/onecli-17d3f772/hJP3XqgFsBDnXHKy/images/integrations/hubspot/buckle-connect-hubspot.png?w=280\u0026fit=max\u0026auto=format\u0026n=hJP3XqgFsBDnXHKy\u0026q=85\u0026s=b794d6dcaa287f11bbfe3f852e2adee8 280w, https://mintcdn.com/onecli-17d3f772/hJP3XqgFsBDnXHKy/images/integrations/hubspot/buckle-connect-hubspot.png?w=560\u0026fit=max\u0026auto=format\u0026n=hJP3XqgFsBDnXHKy\u0026q=85\u0026s=6e7e357ae8d7e760c868354228aa93f8 560w, https://mintcdn.com/onecli-17d3f772/hJP3XqgFsBDnXHKy/images/integrations/hubspot/buckle-connect-hubspot.png?w=840\u0026fit=max\u0026auto=format\u0026n=hJP3XqgFsBDnXHKy\u0026q=85\u0026s=744a159ebd5525c4ecbdd5c7f8837c6d 840w, https://mintcdn.com/onecli-17d3f772/hJP3XqgFsBDnXHKy/images/integrations/hubspot/buckle-connect-hubspot.png?w=1100\u0026fit=max\u0026auto=format\u0026n=hJP3XqgFsBDnXHKy\u0026q=85\u0026s=4a44e235053203e2c6bd47f6621a31b5 1100w, https://mintcdn.com/onecli-17d3f772/hJP3XqgFsBDnXHKy/images/integrations/hubspot/buckle-connect-hubspot.png?w=1650\u0026fit=max\u0026auto=format\u0026n=hJP3XqgFsBDnXHKy\u0026q=85\u0026s=84c46ab0775b702ab095055c846fed1f 1650w, https://mintcdn.com/onecli-17d3f772/hJP3XqgFsBDnXHKy/images/integrations/hubspot/buckle-connect-hubspot.png?w=2500\u0026fit=max\u0026auto=format\u0026n=hJP3XqgFsBDnXHKy\u0026q=85\u0026s=ed5b4d134485432fae0fdfb6da2c5826 2500w`})}),_jsx(_components.p,{children:`Buckle 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 Buckle Cloud.`}),` It’s only for self-hosted Buckle 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:`Buckle`}),`, 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-17d3f772/hJP3XqgFsBDnXHKy/images/integrations/hubspot/01-scopes.png?fit=max\u0026auto=format\u0026n=hJP3XqgFsBDnXHKy\u0026q=85\u0026s=5a9efa7f46167bb5fb0e44ec79b1dd01`,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-17d3f772/hJP3XqgFsBDnXHKy/images/integrations/hubspot/01-scopes.png?w=280\u0026fit=max\u0026auto=format\u0026n=hJP3XqgFsBDnXHKy\u0026q=85\u0026s=f1406cf3da83d64127e89267a952b2e7 280w, https://mintcdn.com/onecli-17d3f772/hJP3XqgFsBDnXHKy/images/integrations/hubspot/01-scopes.png?w=560\u0026fit=max\u0026auto=format\u0026n=hJP3XqgFsBDnXHKy\u0026q=85\u0026s=13d9fc70df3b911e9aae49b6b81ac012 560w, https://mintcdn.com/onecli-17d3f772/hJP3XqgFsBDnXHKy/images/integrations/hubspot/01-scopes.png?w=840\u0026fit=max\u0026auto=format\u0026n=hJP3XqgFsBDnXHKy\u0026q=85\u0026s=ac21bdaf40a3760f9e1e466df4ac76e2 840w, https://mintcdn.com/onecli-17d3f772/hJP3XqgFsBDnXHKy/images/integrations/hubspot/01-scopes.png?w=1100\u0026fit=max\u0026auto=format\u0026n=hJP3XqgFsBDnXHKy\u0026q=85\u0026s=68ee18c41b138b31da27c0d02b4d0fa0 1100w, https://mintcdn.com/onecli-17d3f772/hJP3XqgFsBDnXHKy/images/integrations/hubspot/01-scopes.png?w=1650\u0026fit=max\u0026auto=format\u0026n=hJP3XqgFsBDnXHKy\u0026q=85\u0026s=2395319581ba5c48a04dd2dc5eecffe6 1650w, https://mintcdn.com/onecli-17d3f772/hJP3XqgFsBDnXHKy/images/integrations/hubspot/01-scopes.png?w=2500\u0026fit=max\u0026auto=format\u0026n=hJP3XqgFsBDnXHKy\u0026q=85\u0026s=0c756bb634791aa4a84f227175db98cf 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 Buckle, 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 Buckle Redirect URI in HubSpot's Redirect URLs.`,children:_jsx(OptimizedImage,{src:`https://mintcdn.com/onecli-17d3f772/hJP3XqgFsBDnXHKy/images/integrations/hubspot/02-redirect-url.png?fit=max\u0026auto=format\u0026n=hJP3XqgFsBDnXHKy\u0026q=85\u0026s=90a3bae1bb76c93d8a46962414af70fe`,alt:`HubSpot Redirect URLs section with one entry: https://buckle.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-17d3f772/hJP3XqgFsBDnXHKy/images/integrations/hubspot/02-redirect-url.png?w=280\u0026fit=max\u0026auto=format\u0026n=hJP3XqgFsBDnXHKy\u0026q=85\u0026s=74505c30ddd9eaccf83043df43cfa109 280w, https://mintcdn.com/onecli-17d3f772/hJP3XqgFsBDnXHKy/images/integrations/hubspot/02-redirect-url.png?w=560\u0026fit=max\u0026auto=format\u0026n=hJP3XqgFsBDnXHKy\u0026q=85\u0026s=956ad6b0e402260bc4870d83aabd166e 560w, https://mintcdn.com/onecli-17d3f772/hJP3XqgFsBDnXHKy/images/integrations/hubspot/02-redirect-url.png?w=840\u0026fit=max\u0026auto=format\u0026n=hJP3XqgFsBDnXHKy\u0026q=85\u0026s=6f143386b1d9baf5da9b58d9531d97cc 840w, https://mintcdn.com/onecli-17d3f772/hJP3XqgFsBDnXHKy/images/integrations/hubspot/02-redirect-url.png?w=1100\u0026fit=max\u0026auto=format\u0026n=hJP3XqgFsBDnXHKy\u0026q=85\u0026s=46b3bafb2bb6bc043ecfab3862377974 1100w, https://mintcdn.com/onecli-17d3f772/hJP3XqgFsBDnXHKy/images/integrations/hubspot/02-redirect-url.png?w=1650\u0026fit=max\u0026auto=format\u0026n=hJP3XqgFsBDnXHKy\u0026q=85\u0026s=5f97503442a387e8ab81092a2e62a7b2 1650w, https://mintcdn.com/onecli-17d3f772/hJP3XqgFsBDnXHKy/images/integrations/hubspot/02-redirect-url.png?w=2500\u0026fit=max\u0026auto=format\u0026n=hJP3XqgFsBDnXHKy\u0026q=85\u0026s=793e455dcc8b4ecd763352411168bc27 2500w`})}),_jsx(Frame,{caption:`Copy the Redirect URI from Custom credentials in Buckle.`,children:_jsx(OptimizedImage,{src:`https://mintcdn.com/onecli-17d3f772/h1DTAVlDkLshz4JZ/images/integrations/hubspot/buckle-custom-credentials-hubspot.png?fit=max\u0026auto=format\u0026n=h1DTAVlDkLshz4JZ\u0026q=85\u0026s=cd00ef03a933acb47b5b234c6cf0d7d8`,alt:`Buckle 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\":`820`,height:`820`,\"data-path\":`images/integrations/hubspot/buckle-custom-credentials-hubspot.png`,\"data-optimize\":`true`,\"data-opv\":`3`,srcset:`https://mintcdn.com/onecli-17d3f772/h1DTAVlDkLshz4JZ/images/integrations/hubspot/buckle-custom-credentials-hubspot.png?w=280\u0026fit=max\u0026auto=format\u0026n=h1DTAVlDkLshz4JZ\u0026q=85\u0026s=7aff7e02f5811ff532303624a13bebef 280w, https://mintcdn.com/onecli-17d3f772/h1DTAVlDkLshz4JZ/images/integrations/hubspot/buckle-custom-credentials-hubspot.png?w=560\u0026fit=max\u0026auto=format\u0026n=h1DTAVlDkLshz4JZ\u0026q=85\u0026s=8733461b3826436dccf4c3424a1e9216 560w, https://mintcdn.com/onecli-17d3f772/h1DTAVlDkLshz4JZ/images/integrations/hubspot/buckle-custom-credentials-hubspot.png?w=840\u0026fit=max\u0026auto=format\u0026n=h1DTAVlDkLshz4JZ\u0026q=85\u0026s=9e9b7bbb243d4120b5113602ee79cbef 840w, https://mintcdn.com/onecli-17d3f772/h1DTAVlDkLshz4JZ/images/integrations/hubspot/buckle-custom-credentials-hubspot.png?w=1100\u0026fit=max\u0026auto=format\u0026n=h1DTAVlDkLshz4JZ\u0026q=85\u0026s=790fdd88672fa5cb0658b44b869fab12 1100w, https://mintcdn.com/onecli-17d3f772/h1DTAVlDkLshz4JZ/images/integrations/hubspot/buckle-custom-credentials-hubspot.png?w=1650\u0026fit=max\u0026auto=format\u0026n=h1DTAVlDkLshz4JZ\u0026q=85\u0026s=493bef9e1e8a8b7b6696b80ff3468de5 1650w, https://mintcdn.com/onecli-17d3f772/h1DTAVlDkLshz4JZ/images/integrations/hubspot/buckle-custom-credentials-hubspot.png?w=2500\u0026fit=max\u0026auto=format\u0026n=h1DTAVlDkLshz4JZ\u0026q=85\u0026s=6dfa8ed07baf644e371069455ec84ce4 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. Buckle 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 Buckle, 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://buckle.dev/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-17d3f772/e8c5fc0faf4d8de9/infra/cloudfront/docs-response-headers.js"],"subdomain":"onecli-17d3f772","siteName":"Buckle","title":"Let AI Agents Update HubSpot CRM Records - Buckle","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-11-15T13:34:02.491Z","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=\"Buckle\">\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-17d3f772/eFiEtTXh_9JK0wwc/_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-17d3f772/eFiEtTXh_9JK0wwc/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/docs/mintlify-assets/_mintlify/favicons/onecli-17d3f772/eFiEtTXh_9JK0wwc/_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-17d3f772/eFiEtTXh_9JK0wwc/_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-17d3f772/eFiEtTXh_9JK0wwc/_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-17d3f772/eFiEtTXh_9JK0wwc/_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-17d3f772/eFiEtTXh_9JK0wwc/_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-17d3f772/eFiEtTXh_9JK0wwc/_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-17d3f772/eFiEtTXh_9JK0wwc/_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 - Buckle\">\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=\"Buckle\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://buckle.dev/docs/integrations/hubspot\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://onecli-17d3f772.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=14ca75cbbb2a0e9ba5cd5703\u0026amp;signature=72c2bd851f396db1faacf9ab673b3b6892c41ae1d176b89466e1d2031bd72bb8\">\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 - Buckle\">\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-17d3f772.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=14ca75cbbb2a0e9ba5cd5703\u0026amp;signature=72c2bd851f396db1faacf9ab673b3b6892c41ae1d176b89466e1d2031bd72bb8\">\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-17d3f772/eFiEtTXh_9JK0wwc/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"Buckle\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#ff6a13\">\u003clink data-mint-head rel=\"canonical\" href=\"https://buckle.dev/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-17d3f772.mintlify.dev/#organization\",\"name\":\"Buckle\",\"url\":\"https://onecli-17d3f772.mintlify.dev\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/onecli-17d3f772/5_AFCR2UNaqNo0AT/logo/logo-full-light.svg?fit=max\u0026auto=format\u0026n=5_AFCR2UNaqNo0AT\u0026q=85\u0026s=30ceea1dd3505e0e9dea50b544521ced\"}},{\"@type\":\"WebSite\",\"@id\":\"https://onecli-17d3f772.mintlify.dev/docs#website\",\"name\":\"Buckle\",\"url\":\"https://onecli-17d3f772.mintlify.dev/docs\",\"publisher\":{\"@id\":\"https://onecli-17d3f772.mintlify.dev/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://buckle.dev/docs/integrations/hubspot#webpage\",\"url\":\"https://buckle.dev/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-15T13:34:02.491Z\",\"isPartOf\":{\"@id\":\"https://onecli-17d3f772.mintlify.dev/docs#website\"},\"breadcrumb\":{\"@id\":\"https://buckle.dev/docs/integrations/hubspot#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://buckle.dev/docs/integrations/hubspot#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Cloud integrations\",\"item\":\"https://onecli-17d3f772.mintlify.dev/docs/integrations/apollo-io\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Let AI Agents Update HubSpot CRM Records\",\"item\":\"https://buckle.dev/docs/integrations/hubspot\"}]},{\"@type\":[\"Article\",\"TechArticle\"],\"@id\":\"https://buckle.dev/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://buckle.dev/docs/integrations/hubspot\",\"mainEntityOfPage\":{\"@id\":\"https://buckle.dev/docs/integrations/hubspot#webpage\"},\"dateModified\":\"2026-11-15T13:34:02.491Z\",\"publisher\":{\"@id\":\"https://onecli-17d3f772.mintlify.dev/#organization\"},\"isPartOf\":{\"@id\":\"https://onecli-17d3f772.mintlify.dev/docs#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"Buckle\",\"publisher\":{\"@type\":\"Organization\",\"name\":\"Buckle\"},\"provider\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","agentPointerHref":"/docs/integrations/hubspot.md","siteName":"Buckle","nav":{"global":{"anchors":[{"anchor":"GitHub","icon":"https://mintlify.s3.us-west-1.amazonaws.com/onecli-17d3f772/images/github.svg","href":"https://github.com/buckle"}]},"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 - Buckle","buildId":"dpl_Aw98ji4XvBsgtZwL1VrkUF9ehFqz","deploymentId":"dpl_Aw98ji4XvBsgtZwL1VrkUF9ehFqz","dynamics":["07c022d89b","a74be98ba7"],"chunks":["Frame-0domioUa.js","DynamicMarkdown-BcGRTrw6.js","zoom-image-lightbox-DsiWwPWR.js","lightbox-handle-r17bVUz3.js"]}