{"templateId":"markdown","sharedDataIds":{"sidebar":"sidebar-agen-for-work/sidebars.yaml"},"props":{"metadata":{"markdoc":{"tagList":["Notification","LightboxImage"]},"type":"markdown"},"seo":{"title":"HubSpot integration","siteUrl":"https://developers.frontegg.com/","llmstxt":{"hide":false,"sections":[{"title":"Table of contents","includeFiles":["**/*"],"excludeFiles":[]}],"excludeFiles":[]}},"dynamicMarkdocComponents":[],"compilationErrors":[],"ast":{"$$mdtype":"Tag","name":"article","attributes":{},"children":[{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"hubspot-integration","__idx":0},"children":["HubSpot integration"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["HubSpot is a CRM platform that helps businesses manage contacts, companies, deals, and customer interactions. Integrating HubSpot with Frontegg allows your application to read and write CRM data — including contacts, companies, deals, quotes, and owners — on behalf of your users through OAuth 2.0 authentication."]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Notification","attributes":{"title":"Prerequisites","type":"attention"},"children":[{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["A HubSpot account with developer access"]}]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"connect-hubspot","__idx":1},"children":["Connect HubSpot"]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":4,"id":"step-1-open-the-developer-portal","__idx":2},"children":["Step 1: Open the developer portal"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Go to ",{"$$mdtype":"Tag","name":"a","attributes":{"href":"https://developers.hubspot.com/"},"children":["developers.hubspot.com"]}," and sign in with your HubSpot account."]},{"$$mdtype":"Tag","name":"LightboxImage","attributes":{"isLightbox":true},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"img","attributes":{"src":"/assets/hubspot-1.70470d4cc10b98b28d4cca98bedd7dec74b5ccb90dee0a3f6dc84c28b65b8f67.1ce25488.png","alt":"HubSpot developer portal homepage"},"children":[]}]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":4,"id":"step-2-go-to-legacy-apps","__idx":3},"children":["Step 2: Go to Legacy Apps"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Once signed in, you will be in your HubSpot developer account. In the left sidebar, navigate to ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Development"]}," → ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Legacy Apps"]},". This page lists all existing applications in your account."]},{"$$mdtype":"Tag","name":"LightboxImage","attributes":{"isLightbox":true},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"img","attributes":{"src":"/assets/hubspot-2.0b4402749e515c30bc5c28ad636eda2a8d97d2d7d249880aa09210f8966474ba.1ce25488.png","alt":"HubSpot Legacy Apps list"},"children":[]}]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":4,"id":"step-3-create-a-new-app","__idx":4},"children":["Step 3: Create a new app"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Click ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Create legacy app"]}," in the top right corner."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["In the dialog that appears, select ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Public"]}," (for apps that can be installed by any HubSpot account) and click ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Next"]},"."]},{"$$mdtype":"Tag","name":"LightboxImage","attributes":{"isLightbox":true},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"img","attributes":{"src":"/assets/hubspot-3.b63ee6cd2e2e0f8c9c7768312126a2e5704da00c64ce6fae324cbb28768edd6d.1ce25488.png","alt":"HubSpot Create Legacy App dialog"},"children":[]}]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":4,"id":"step-4-fill-in-the-app-name","__idx":5},"children":["Step 4: Fill in the app name"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["On the ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["App Info"]}," tab, enter a name for your application in the ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Public app name"]}," field (for example, \"Frontegg Integration\"). This name appears in HubSpot tools when users install your app."]},{"$$mdtype":"Tag","name":"LightboxImage","attributes":{"isLightbox":true},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"img","attributes":{"src":"/assets/hubspot-4.490a26901c55979828492723a802ff7226e093089277de9bc746aaa83811e576.1ce25488.png","alt":"HubSpot app name form"},"children":[]}]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":4,"id":"step-5-configure-auth-settings","__idx":6},"children":["Step 5: Configure auth settings"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Click the ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Auth"]}," tab to open the authentication configuration page."]},{"$$mdtype":"Tag","name":"LightboxImage","attributes":{"isLightbox":true},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"img","attributes":{"src":"/assets/hubspot-5.5fbd660f759b2f6cba8d917797e6f73c8fc6a6a60c233aa74df7567348c16743.1ce25488.png","alt":"HubSpot Auth settings tab"},"children":[]}]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":4,"id":"step-6-add-redirect-urls","__idx":7},"children":["Step 6: Add redirect URLs"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Scroll down to the ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Redirect URLs"]}," section. Enter the following redirect URLs, adding each one separately by typing the URL and clicking ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["+ Add redirect URL"]},":"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["https://YOUR_MCP_GATEWAY_URL/integration-callback"]}]}]},{"$$mdtype":"Tag","name":"LightboxImage","attributes":{"isLightbox":true},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"img","attributes":{"src":"/assets/hubspot-6.fd158d662490ecb3780b97c2e12800a3c95c897f446ebec71d0a607cd1bc33a6.1ce25488.png","alt":"HubSpot redirect URLs configuration"},"children":[]}]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":4,"id":"step-7-add-oauth-scopes","__idx":8},"children":["Step 7: Add OAuth scopes"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Scroll down to the ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Scopes"]}," section and click ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Add new scope"]},". Select the required scopes from the list:"]},{"$$mdtype":"Tag","name":"div","attributes":{"className":"md-table-wrapper"},"children":[{"$$mdtype":"Tag","name":"table","attributes":{"className":"md"},"children":[{"$$mdtype":"Tag","name":"thead","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Scope"},"children":["Scope"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Description"},"children":["Description"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["crm.objects.contacts.read"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Read contact records"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["crm.objects.contacts.write"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Create and update contact records"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["crm.objects.companies.read"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Read company records"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["crm.objects.companies.write"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Create and update company records"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["crm.objects.deals.read"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Read deal records"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["crm.objects.deals.write"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Create and update deal records"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["crm.objects.owners.read"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Read owner (user) records"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["crm.objects.quotes.read"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Read quote records"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["crm.objects.quotes.write"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Create and update quote records"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["crm.objects.line_items.read"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Read line item records"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["crm.objects.line_items.write"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Create and update line item records"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["crm.schemas.contacts.read"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Read contact property schemas"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["crm.schemas.companies.read"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Read company property schemas"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["crm.schemas.deals.read"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Read deal property schemas"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["crm.schemas.custom.read"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Read custom object schemas"]}]}]}]}]},{"$$mdtype":"Tag","name":"Notification","attributes":{"title":"Minimum required scopes","type":"info"},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["For basic CRM functionality, you need: ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["crm.objects.contacts.read"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["crm.objects.companies.read"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["crm.objects.deals.read"]},"."]}]},{"$$mdtype":"Tag","name":"LightboxImage","attributes":{"isLightbox":true},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"img","attributes":{"src":"/assets/hubspot-7.15458a581d7c06a5aa2cf441d3e192eb7551792c32935d498f52dd02c5826106.1ce25488.png","alt":"HubSpot scope selection dialog"},"children":[]}]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["After selecting all required scopes, click ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Update"]},"."]},{"$$mdtype":"Tag","name":"LightboxImage","attributes":{"isLightbox":true},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"img","attributes":{"src":"/assets/hubspot-8.28b4e40c9e2ee048917471d9dd23cf8413429c3919eb50e6fce86429fb50e247.1ce25488.png","alt":"HubSpot scopes selected"},"children":[]}]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":4,"id":"step-8-create-the-app","__idx":9},"children":["Step 8: Create the app"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Once all required details are set, click ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Create app"]}," at the bottom of the page."]},{"$$mdtype":"Tag","name":"LightboxImage","attributes":{"isLightbox":true},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"img","attributes":{"src":"/assets/hubspot-9.ce277c844b9604b139971dd70919a8f4ecd1a90167641d3970741a6a3a543064.1ce25488.png","alt":"HubSpot Create app button enabled"},"children":[]}]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":4,"id":"step-9-copy-your-credentials","__idx":10},"children":["Step 9: Copy your credentials"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["After the app is created, the ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Auth settings"]}," page displays your app credentials:"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Client ID"]}," — Your app's unique identifier used to initiate OAuth."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Client secret"]}," — Click ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Show"]}," to reveal the secret. Used to exchange authorization codes for access tokens."]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Copy both values and store them securely."]},{"$$mdtype":"Tag","name":"Notification","attributes":{"title":"Keep your credentials secure","type":"attention"},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Never share or commit your Client secret to version control."]}]},{"$$mdtype":"Tag","name":"LightboxImage","attributes":{"isLightbox":true},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"img","attributes":{"src":"/assets/hubspot-10.c85dcabe2a9ce4f702a00f7d5c762283224fb0b6b2a419860bfffc3e3bdcdcef.1ce25488.png","alt":"HubSpot app credentials page"},"children":[]}]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"configure-the-frontegg-portal","__idx":11},"children":["Configure the Frontegg portal"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Once you have obtained your ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Client ID"]}," and ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Client secret"]}," from the steps above, enter them in the integration configuration page of the Frontegg portal:"]},{"$$mdtype":"Tag","name":"ol","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Open the ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Frontegg portal"]}," and navigate to [ENVIRONMENT] → Integrations → HubSpot."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Enter the ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Client ID"]}," and ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Client secret"]}," in the corresponding fields."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Select the required ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["scopes"]},"."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Click ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Save"]},"."]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"additional-resources","__idx":12},"children":["Additional resources"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"a","attributes":{"href":"https://developers.hubspot.com/docs/guides/crm/understanding-the-crm"},"children":["HubSpot API documentation"]}]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"a","attributes":{"href":"https://developers.hubspot.com/docs/api/working-with-oauth"},"children":["HubSpot OAuth guide"]}]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"a","attributes":{"href":"https://developers.hubspot.com/"},"children":["HubSpot developers home"]}]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"a","attributes":{"href":"/agen-for-work/connectors/redirect-url"},"children":["How to get your Redirect URL"]}]}]}]}]},"headings":[{"value":"HubSpot integration","id":"hubspot-integration","depth":2},{"value":"Connect HubSpot","id":"connect-hubspot","depth":3},{"value":"Step 1: Open the developer portal","id":"step-1-open-the-developer-portal","depth":4},{"value":"Step 2: Go to Legacy Apps","id":"step-2-go-to-legacy-apps","depth":4},{"value":"Step 3: Create a new app","id":"step-3-create-a-new-app","depth":4},{"value":"Step 4: Fill in the app name","id":"step-4-fill-in-the-app-name","depth":4},{"value":"Step 5: Configure auth settings","id":"step-5-configure-auth-settings","depth":4},{"value":"Step 6: Add redirect URLs","id":"step-6-add-redirect-urls","depth":4},{"value":"Step 7: Add OAuth scopes","id":"step-7-add-oauth-scopes","depth":4},{"value":"Step 8: Create the app","id":"step-8-create-the-app","depth":4},{"value":"Step 9: Copy your credentials","id":"step-9-copy-your-credentials","depth":4},{"value":"Configure the Frontegg portal","id":"configure-the-frontegg-portal","depth":3},{"value":"Additional resources","id":"additional-resources","depth":3}],"frontmatter":{"seo":{"title":"HubSpot integration"}},"lastModified":"2026-05-01T18:45:25.000Z","pagePropGetterError":{"message":"","name":""}},"slug":"/agen-for-work/connectors/marketplace/hubspot","userData":{"isAuthenticated":false,"teams":["anonymous"]},"isPublic":true}