{"templateId":"markdown","sharedDataIds":{"sidebar":"sidebar-agen-for-work/sidebars.yaml"},"props":{"metadata":{"markdoc":{"tagList":["Notification","LightboxImage"]},"type":"markdown"},"seo":{"title":"HubSpot Marketing 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-marketing-integration","__idx":0},"children":["HubSpot Marketing integration"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["HubSpot Marketing Hub is the marketing automation product within the HubSpot platform — it powers forms, email campaigns, landing pages, marketing events, social posts, contact lists, marketing analytics, and workflows. Integrating HubSpot Marketing with Frontegg allows your application to read and write Marketing Hub data — including aggregate email and campaign analytics, and workflow enrollments — 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":"li","attributes":{},"children":["A HubSpot Marketing Hub subscription with access to the features you plan to use (forms, email, landing pages, social, etc.)"]}]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"connect-hubspot-marketing","__idx":1},"children":["Connect HubSpot Marketing"]},{"$$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-marketing-1.2d47eb78e0e23b2f67a567259ef63a1537900fa867a2e5be9167d314ab98730c.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":"p","attributes":{},"children":["Click ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Create legacy app"]}," in the top right corner."]},{"$$mdtype":"Tag","name":"LightboxImage","attributes":{"isLightbox":true},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"img","attributes":{"src":"/assets/hubspot-marketing-2.8a3364656342cb691a8db9323430a772b98e849b47d246e7bb8329e3cfe1afee.1ce25488.png","alt":"HubSpot Legacy Apps list"},"children":[]}]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":4,"id":"step-3-choose-public-app-type","__idx":4},"children":["Step 3: Choose Public app type"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["In the ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Create Legacy App"]}," dialog that appears, select ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Public"]}," (for apps that can be installed by any HubSpot account)."]},{"$$mdtype":"Tag","name":"LightboxImage","attributes":{"isLightbox":true},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"img","attributes":{"src":"/assets/hubspot-marketing-3.5903e7d039e6fd8812bfba7844b150d0811748626cb1d981c00e5a6fc8a95824.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 Marketing 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-marketing-4.f73d1936b3a3d6639faaa654bc7484628127a69868100cf53daa3cb756275f2c.1ce25488.png","alt":"HubSpot app name form"},"children":[]}]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":4,"id":"step-5-open-auth-settings","__idx":6},"children":["Step 5: Open auth settings"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Click the ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Auth"]}," tab to open the authentication configuration page. The ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["App credentials"]},", ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Redirect URLs"]},", and ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Scopes"]}," sections all live here."]},{"$$mdtype":"Tag","name":"LightboxImage","attributes":{"isLightbox":true},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"img","attributes":{"src":"/assets/hubspot-marketing-5.e985f69c6d290ef7dc394669746f06e1ad9afb1464302deb697a3fcdf9b1b82c.1ce25488.png","alt":"HubSpot Auth settings tab"},"children":[]}]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":4,"id":"step-6-add-the-redirect-url","__idx":7},"children":["Step 6: Add the redirect URL"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Scroll down to the ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Redirect URLs"]}," section. Enter your Frontegg redirect URL:"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"header":{"controls":{"copy":{}}},"source":"https://YOUR_MCP_GATEWAY_URL/integration-callback\n"},"children":[]},{"$$mdtype":"Tag","name":"LightboxImage","attributes":{"isLightbox":true},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"img","attributes":{"src":"/assets/hubspot-marketing-6.b0cacb7c4352effea457de3c2ff6dad7dc00bbcf6e71faf81aad6378dfcb2918.1ce25488.png","alt":"HubSpot redirect URL configuration"},"children":[]}]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":4,"id":"step-7-open-the-scope-picker","__idx":8},"children":["Step 7: Open the scope picker"]},{"$$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"]},". The scope picker dialog opens, grouped by category (CRM, CMS, Automation, Marketing, etc.). Use the search field to find specific scopes quickly."]},{"$$mdtype":"Tag","name":"LightboxImage","attributes":{"isLightbox":true},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"img","attributes":{"src":"/assets/hubspot-marketing-7.41967b821310875f388f88e083df454392c54ed0a89c5bd7099219b090d7e669.1ce25488.png","alt":"HubSpot scope picker"},"children":[]}]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":4,"id":"step-8-select-the-marketing-scopes","__idx":9},"children":["Step 8: Select the Marketing scopes"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Select the following scopes:"]},{"$$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":["forms"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Read and write HubSpot forms"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["content"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Read and write marketing content — emails, landing pages, and campaigns"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["social"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Read and write social media posts and channels"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["crm.lists.read"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Read contact lists"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["crm.lists.write"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Create and update contact lists"]}]},{"$$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 (used for list members and email recipients)"]}]},{"$$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.marketing_events.read"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Read marketing events (webinars, conferences, etc.) and event participation breakdowns"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["crm.objects.marketing_events.write"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Create, update, and complete marketing events"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["marketing-email"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Read aggregate marketing-email statistics (sends, opens, clicks, bounces, unsubscribes) and time-bucketed histograms"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["marketing.campaigns.read"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Read aggregate campaign performance metrics across associated assets"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["marketing.campaigns.revenue.read"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Read campaign revenue attribution data (required alongside ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["marketing.campaigns.read"]}," for revenue reports)"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["automation"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["List and read workflows, and enroll or unenroll contacts in workflows"]}]}]}]}]},{"$$mdtype":"Tag","name":"Notification","attributes":{"title":"Minimum required scopes","type":"info"},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["For basic Marketing Hub functionality, you need at least ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["forms"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["content"]},", and ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["crm.objects.contacts.read"]},". Add ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["marketing-email"]}," and ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["marketing.campaigns.read"]}," for reporting and analytics, ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["marketing.campaigns.revenue.read"]}," for revenue attribution, and ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["automation"]}," for workflow enrollments."]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["After selecting all required scopes, click ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Update"]},". The selected scopes appear under ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Required scopes"]}," on the Auth page, alongside the always-required ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["oauth"]}," scope."]},{"$$mdtype":"Tag","name":"LightboxImage","attributes":{"isLightbox":true},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"img","attributes":{"src":"/assets/hubspot-marketing-8.a52658ac3fb02cd9c0843403b123db596372187c760565358c60f8eb41ecc9e1.1ce25488.png","alt":"HubSpot scopes selected"},"children":[]}]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":4,"id":"step-9-create-the-app-and-copy-your-credentials","__idx":10},"children":["Step 9: Create the app and copy your credentials"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Click ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Create app"]}," at the bottom of the page. Once the app is created, the ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["App credentials"]}," section at the top of the Auth page displays your 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-marketing-9.1e8da85e4206da7134f821e73650adeebc7b94ee1ae2725b463acd194f382928.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] → Connectors → HubSpot Marketing."]},{"$$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/api/marketing/marketing-overview"},"children":["HubSpot Marketing API overview"]}]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"a","attributes":{"href":"https://developers.hubspot.com/docs/guides/api/marketing/forms"},"children":["HubSpot Forms API"]}]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"a","attributes":{"href":"https://developers.hubspot.com/docs/guides/api/marketing/emails/marketing-emails"},"children":["HubSpot Marketing Email API"]}]}]},{"$$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 Marketing integration","id":"hubspot-marketing-integration","depth":2},{"value":"Connect HubSpot Marketing","id":"connect-hubspot-marketing","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: Choose Public app type","id":"step-3-choose-public-app-type","depth":4},{"value":"Step 4: Fill in the app name","id":"step-4-fill-in-the-app-name","depth":4},{"value":"Step 5: Open auth settings","id":"step-5-open-auth-settings","depth":4},{"value":"Step 6: Add the redirect URL","id":"step-6-add-the-redirect-url","depth":4},{"value":"Step 7: Open the scope picker","id":"step-7-open-the-scope-picker","depth":4},{"value":"Step 8: Select the Marketing scopes","id":"step-8-select-the-marketing-scopes","depth":4},{"value":"Step 9: Create the app and copy your credentials","id":"step-9-create-the-app-and-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":{"category":"Marketing","displayName":"HubSpot Marketing","seo":{"title":"HubSpot Marketing integration"}},"lastModified":"2026-05-19T15:06:34.000Z","pagePropGetterError":{"message":"","name":""}},"slug":"/agen-for-work/connectors/marketplace/hubspot-marketing","userData":{"isAuthenticated":false,"teams":["anonymous"]},"isPublic":true}