Choosing a distribution path before onboarding first design partners: install confirmation, private

We are preparing our first OAuth app for a HubSpot App Marketplace listing and are about to onboard our first external customers as design partners. The app is currently configured with marketplace distribution, is not yet listed, runs in the EU data centre, and our developer domain is verified. Before we choose the path, three questions.

1. Unlisted-app install confirmation. When a customer installs our unlisted OAuth app, HubSpot shows an “unverified app” confirmation and requires the user to type “I accept the risk”. Is approval of the Marketplace listing the only thing that removes this step, or is there a separate app verification, pre-review or other process that removes it before the listing is approved?

2. Private OAuth distribution. If the same OAuth app were configured with private distribution and installed into an allowlisted external customer account, would that customer still see the same “unverified app / I accept the risk” confirmation? To be clear about what I mean: a privately distributed OAuth app installed into an external customer portal, not a private app created only for use inside our own portal.

3. Switching distribution later. We are on marketplace distribution today. If we switched this project to private distribution for a small number of design partners and later switched it back to marketplace distribution, would the existing customer installations and OAuth grants be preserved, or would those customers have to reinstall or reauthorise?

We are trying to pick the right path for the first design partners without creating migration work later.

Hi @NAR27 and welcome to the HubSpot Community! :confetti_ball:

Thanks for the great questions!

I believe these resources can point you in the right direction:

Now, let’s hear from our Top Experts: Hi @Anton, @evaldas and @zach_threadint do you have suggestions, please?

Have a lovely day, and thanks so much!

Bérangère, HubSpot Community Manager

I’d be careful about switching distribution types just to get around the install warning

HubSpot’s documentation confirms that a project-based private OAuth app can move to marketplace distribution without interrupting existing installs. I haven’t found the same guarantee for switching back and forth.

The unverified-app confirmation is a separate issue. HubSpot introduced it for third-party apps that haven’t gone through Marketplace quality review, so changing the distribution setting alone may not remove it.

For your first design partners, I’d test the full installation flow in a separate customer portal and keep the app’s distribution stable until HubSpot confirms the migration path.

Official references: