CRITICAL: No way to test new seamless install flow before production

Hi HubSpot Developer Community,

There’s a critical gap in the developer experience for the new seamless install flow:

PROBLEM:

1. Seamless flow only works through marketplace listings (preview mode)

2. Marketplace listings require 3 production installs

3. We must use old OAuth flow to get those installs

4. Preview doesn’t trigger real OAuth (can’t test)

5. Can’t rollback after publishing

6. Documentation doesn’t cover conditional scopes behavior

RESULT: We’re forced to publish to production WITHOUT being able to test:

- How conditional scopes work in seamless flow

- Whether tier-based features will work

- If our integration logic handles step=authorize/finalize correctly

REQUEST: Please provide either:

1. Way to enable seamless flow for unlisted apps

2. Complete documentation on conditional scopes in seamless flow

Our app relies on conditional scopes for different pricing tiers. Publishing without testing could block our development timeline.

Any guidance on how to test the seamless install flow before production would be extremely helpful. We’re happy to work with your team to find a solution.

Hi @AlexShestakov,
Thank you for posting to the Community!
I’d like to tag in some of our Top Contributors to see if they are also able to reproduce this behavior on their end. Hi @Mike_Eastwood @WesQ and @HubSpot_Corey Are you all seeing the same behavior as @AlexShestakov? If so, do you have any workarounds that you would suggest?
Thank you!
Cassie, Community Manager

Hi @AlexShestakov

This has been stressing me out too!

In your App Listing Page you can apply for an exemption which [I’m told] will remove the Install Button from the listing.

And [I’ve been told] you can install your app from your website without using the new seamless install flow.
The team in charge have been really responsive, I am sending them a video today to show them why the seamless install flow doesn’t work for my apps (we use both product types and tiers that control the redirects).

“All part of the fun”

Mike

p.s. thank you for the mention @chighsmith

Here to learn more about HubSpot and share my HubSpot Knowledge. I’m the founder of Webalite a Gold HubSpot Partner Agency based in Wellington, New Zealand and the founder of Portal-iQ the world’s first automated HubSpot Portal Audit that helps you work smarter with HubSpot.

@Mike_Eastwood I am working on updating the dev doc to include the information about the exemption flow and how apps can request it from the listing editor after opting into Seamless install.

@AlexShestakov I am the Marketplace PM who owns this feature. Can you explain what you mean by conditional scopes behavior and tier based features ? We havent made changes to the actual install process (e.g. OAuth, scopes etc..) so they should work similar to how they are working now.

The only change is that we initiate and complete the install within HubSpot so the app will need to redirect the user back to HubSpot once it has the customer information (e.g. sing in/sign up, connection to other software etc…)

Hi Harish! Thank you for reaching out.
We use a list of conditionallyRequiredScopes in the app-hsmeta.json. It allows us to apply different sets of scopes during the /oauth/authorize request, depending on the user’s preferences and tier.
According to the current HubSpot documentation, the new seamless flow doesn’t include this request step, and we are not able to use conditionallyRequiredScopes.
I wanted to clarify whether it is available in the new flow and how it works, if so.
Also, as I mentioned in my initial post, it is not possible at the moment to test the full flow without being listed.

@alex We are looking into this currently. I will post an update here with the solution for the conditional scopes ask by early next week.

Update: End to End install flow testing is now possible from the listing preview. Apps should be able to test out their install flow from the listing preview in listing editor

Hello @Hsrinivasan

We’re currently experiencing issues with the new Seamless Install flow.

Everything worked correctly in Preview — when clicking the Install button, a popup appeared with the “Connect to…” title and a Sign In button. Clicking Sign In redirected to our new install endpoint with the correct step and returnUrl query parameters.

However, after publishing to the Marketplace, the behavior changed. The Install button now redirects directly to the install endpoint:

  • the popup is no longer displayed
  • the required query parameters are not being added

Could you please help us understand why this is happening and how we can restore the expected flow?

Thank you in advance.