{"registry_version":"2026.1025.387","generated_at":"2026-10-25T06:27:00Z","content_sha256":"089d16f627d9365e3d0663cc8069203706d7cb23a76c332226e29686968811a5","signed":true,"signature":{"key_id":"ed25519:74ca19268e364242","algorithm":"ed25519","expires_at":"2026-11-24T06:27:09Z","expired":false,"manifest":"/registry/manifest.json"},"id":"hubspot/app","name":"HubSpot app (developer platform, legacy private app, Marketplace listing)","vendor":"HubSpot","status":"researched","last_verified":null,"last_researched":"2026-10-25","summary":"Build an app on HubSpot's developer platform with the HubSpot CLI (static auth for one account, OAuth for many), or use a legacy private app token; a Marketplace listing needs OAuth only, three active installs and HubSpot's quality review.","account_model":{"summary":"Apps live in a HubSpot developer account (projects) or, for legacy private apps, in the customer's HubSpot account.","accounts":[{"name":"HubSpot developer account","kind":"developer","required":false,"note":"For developer-platform apps and Marketplace listings; test in a developer test account."},{"name":"HubSpot account (customer portal)","kind":"organisation","required":true,"note":"Super admin needed for legacy private apps."}]},"prerequisites":[{"need":"Node.js and the HubSpot CLI for developer-platform apps"}],"identity_requires":[],"have_ready":[],"steps":[{"id":"private_app","title":"Legacy private app token (single account, quickest)","summary":"As a super admin go to Development > Legacy apps > Create legacy app > Private; set name, scopes and optional webhooks; Create app; Show token on the Auth tab.","route":"copilot","gate":"human_submit","human_only":true,"gate_label":"You press submit","depends_on":[],"optional":true,"url":"https://app.hubspot.com/","lead_time":null,"preflight":[],"captures":"HUBSPOT_ACCESS_TOKEN"},{"id":"cli_project","title":"Create a developer-platform app with the CLI","summary":"Run hs project create (or hs get-started), choose distribution (private or marketplace) and auth (static or oauth) in app-hsmeta.json, upload to your developer account and test-install in a developer test account.","route":"guided","gate":"none","human_only":false,"gate_label":null,"depends_on":[],"optional":true,"url":null,"lead_time":null,"preflight":[],"captures":null},{"id":"oauth_credentials","title":"Copy OAuth client ID and secret","summary":"For oauth apps, copy the client ID and secret from the app's auth settings in the developer account [to verify location].","route":"copilot","gate":"none","human_only":false,"gate_label":null,"depends_on":["cli_project"],"optional":true,"url":"https://app.hubspot.com/","lead_time":null,"preflight":[],"captures":"HUBSPOT_CLIENT_SECRET"},{"id":"marketplace_listing","title":"Submit a Marketplace listing","summary":"Needs OAuth-only auth, minimal used scopes, and at least three active unaffiliated installs in the past 30 days; submit one app at a time.","route":"guided","gate":"third_party_review","human_only":true,"gate_label":"The provider reviews it","depends_on":["oauth_credentials"],"optional":true,"url":null,"lead_time":{"official":{"text":"Initial review within 10 business days; full review and feedback process no more than 60 days from when feedback is shared.","source_url":"https://developers.hubspot.com/docs/apps/developer-platform/list-apps/listing-your-app/app-marketplace-listing-requirements","source_title":"App listing requirements in the HubSpot Marketplace"},"reported":null,"typical_minutes":null},"preflight":[],"captures":null}],"gates":[{"step":"private_app","gate":"human_submit","label":"You press submit"},{"step":"marketplace_listing","gate":"third_party_review","label":"The provider reviews it"}],"lead_times":[{"step":"marketplace_listing","what":"Submit a Marketplace listing","official":{"text":"Initial review within 10 business days; full review and feedback process no more than 60 days from when feedback is shared.","source_url":"https://developers.hubspot.com/docs/apps/developer-platform/list-apps/listing-your-app/app-marketplace-listing-requirements","source_title":"App listing requirements in the HubSpot Marketplace"},"reported":null}],"outputs":[{"name":"HUBSPOT_ACCESS_TOKEN","description":"Legacy private app (or static auth) access token","secret":true,"example_format":"opaque token string","environments":null},{"name":"HUBSPOT_CLIENT_ID","description":"OAuth app client ID","secret":false,"example_format":"opaque string","environments":null},{"name":"HUBSPOT_CLIENT_SECRET","description":"OAuth app client secret","secret":true,"example_format":"opaque string","environments":null}],"renewals":[{"what":"Rotate private app access token (HubSpot recommendation)","every":"6 months","every_days":180,"source_url":"https://developers.hubspot.com/docs/apps/legacy-apps/private-apps/overview"}],"estimated_minutes":null,"guide_url":"https://verapli.com/guides/hubspot/app"}