{"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":{"title":"Frontegg Developer Documentation","description":"Authentication, authorization, and user management for Customer Identity, plus Agen for SaaS and Agen for Work. Guides, SDKs, and API references.","sections":[{"title":"Customer Identity (CIAM)","description":"Auth, SSO, SCIM, entitlements, and user management — guides, SDKs, and APIs.","includeFiles":["ciam/**/*.md"],"excludeFiles":[]},{"title":"Agen for SaaS","description":"Agentic access and authorization for SaaS products.","includeFiles":["agen-for-saas/**/*.md"],"excludeFiles":[]},{"title":"Agen for Work","description":"Agentic access and authorization for internal and workforce use.","includeFiles":["agen-for-work/**/*.md"],"excludeFiles":[]},{"title":"Platform","description":"Shared platform overview.","includeFiles":["platform/**/*.md"],"excludeFiles":[]}],"excludeFiles":["internal-docs/**","ciam/guides/env-settings/inject-client-ip.md","CLAUDE.md","**/images/**"],"hide":false}},"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, marketing emails, landing pages, marketing events, contact lists, and workflows. Integrating HubSpot Marketing with Frontegg allows your application to read and write Marketing Hub data — including forms, emails, landing pages, marketing events, contact lists, 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 developer account to create the app — free to sign up at ",{"$$mdtype":"Tag","name":"a","attributes":{"href":"https://developers.hubspot.com/"},"children":["developers.hubspot.com"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["A HubSpot Marketing Hub subscription with access to the features you plan to use (forms, email, landing pages, marketing events, etc.)"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["For campaigns and marketing analytics, a ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Marketing Hub Professional"]}," subscription or higher — the campaign and email-statistics scopes are not granted on the Free tier"]}]}]},{"$$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, 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":["HubSpot Marketing scopes fall into two groups. The ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["core scopes"]}," are granted on every Marketing Hub tier, including Free. The ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Professional+ scopes"]}," are tier-gated — HubSpot only grants them on Marketing Hub Professional or higher."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Core scopes (all tiers)"]}]},{"$$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 — marketing emails and landing pages"]}]},{"$$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 and their members"]}]},{"$$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 their participation analytics"]}]},{"$$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 and update marketing events"]}]},{"$$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":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Marketing Hub Professional+ scopes (optional, tier-gated)"]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Add these scopes only if you plan to use the Campaigns, email statistics, and campaign analytics (metrics and revenue) tools. HubSpot grants them only on ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Marketing Hub Professional or higher"]}," — on the Free tier, OAuth consent fails with a \"lacks access to required scopes\" error if any of them are requested."]},{"$$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":["marketing.campaigns.read"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["List and read campaigns, and read campaign metrics"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["marketing.campaigns.write"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Create campaigns"]}]},{"$$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"]}]},{"$$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 marketing email send statistics (list, histogram, and per-email)"]}]}]}]}]},{"$$mdtype":"Tag","name":"Notification","attributes":{"title":"Minimum required scopes","type":"info"},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["For basic Marketing Hub functionality on any tier, the core scopes are enough: ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["forms"]}," and ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["content"]}," cover forms, emails, and landing pages; add ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["crm.lists.read"]}," for contact lists, ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["crm.objects.marketing_events.*"]}," for marketing events, and ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["automation"]}," for workflow enrollments. The Professional+ scopes are needed only for the Campaigns, email-statistics, and campaign-analytics tools."]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["For each scope, the picker lets you choose ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Required"]},", ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Conditionally required"]},", or ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Optional"]}," — this controls whether HubSpot requests the scope on every install or only when an enabled tool needs it."]},{"$$mdtype":"Tag","name":"Notification","attributes":{"title":"Tier-gated scopes must be Conditionally required","type":"attention"},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Set the four tier-gated scopes — ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["marketing.campaigns.read"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["marketing.campaigns.write"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["marketing.campaigns.revenue.read"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["marketing-email"]}," — to ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Conditionally required"]},", never ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Required"]},". A Required scope is requested on every install regardless of which tools the customer enabled, so a Required tier-gated scope makes OAuth consent fail for every Free-tier customer — even when the Campaigns and analytics tools are turned off. Conditionally required scopes are only requested when an enabled tool needs them. Only ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["oauth"]}," should be Required — HubSpot adds it automatically."]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["After selecting your 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-marketing-8.a52658ac3fb02cd9c0843403b123db596372187c760565358c60f8eb41ecc9e1.1ce25488.png","alt":"HubSpot scopes selected"},"children":[]}]}]},{"$$mdtype":"Tag","name":"Notification","attributes":{"title":"Tier compatibility","type":"attention"},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["On a ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Free Marketing Hub"]}," account, all core tools work — including the event-participation analytics tools, which run on the core ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["crm.objects.marketing_events.read"]}," scope. Only the ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Campaigns"]},", ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["email statistics"]},", and ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["campaign analytics"]}," (metrics and revenue) tools require ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Marketing Hub Professional or higher"]},". If a customer on the Free tier installs the integration with the Professional+ scopes requested, HubSpot rejects the OAuth consent."]}]},{"$$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":"Notification","attributes":{"title":"Managing tools by tier","type":"info"},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The tier-gated tools — ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Campaigns"]}," (list, get, create), ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Email Statistics"]}," (×3), ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Campaign Metrics"]},", and ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Campaign Revenue"]}," — should be kept ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["disabled"]}," in the connector's tool list for tenants on a Free Marketing Hub. With those tools off, their scopes are excluded from the OAuth consent and the installation completes cleanly. On Marketing Hub Professional or higher, you can enable them."]}]},{"$$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-29T13:43:28.000Z","pagePropGetterError":{"message":"","name":""}},"slug":"/agen-for-work/connectors/marketplace/hubspot-marketing","userData":{"isAuthenticated":false,"teams":["anonymous"]},"isPublic":true}