Couldn't migrate our public app to project app due to UNLISTED_APP_OVER_PRIVATE_INSTALL_LIMIT

Developer Support APIs & Integrations
1

Hi,

I am trying to migrate one of our legacy public apps to 2026.03.
When I run hs app migrate, the app I want to migrate shows the following:

unmigratableReason: 'UNLISTED_APP_OVER_PRIVATE_INSTALL_LIMIT', isMigratable: false

This is our private app that we don’t tend to list it op in Marketplace, so we distributed it privately. I understood that we couldn’t migrate it due to too many private install. I have some question need to have answer from you guys expert

  • Are there anyway to overcome this except for asking all client to uninstall it? Because it’s impossible for us to ask them to uninstall this app.
  • We couldn’t see exact number of installed account in our legacy app Monitoring section, but from our own management, there are around 30 HubSpot portal that install our private app.
  • From document, I saw that we only can install maximum 10 accounts with OAuth based distribution in normal developer account (100 for Solution Partner). We’re just normal developer accounts but our app could be still installed in more than 30 portals? What is the reason?

Please guide us for the next actions that we could do to be able to migrate this legacy package.
Thank you very much!

3

Hi @son.nguyen.developer and welcome, it’s so nice to have you here!

Great questions, thanks for asking the HubSpot Community and diving into the migration details!

The UNLISTED_APP_OVER_PRIVATE_INSTALL_LIMIT error means your legacy public app has too many installs to migrate as a privately distributed app (limit: 10 for standard developer accounts, 100 for Solution Partners).

And regarding the question, “Why could your app exceed 30 installs if the limit is 10?”: The 10/100 install limits were introduced on September 22, 2025 and only apply to new or migrated apps on the new developer platform. Your legacy public app was created before these limits existed, so it accumulated installs without restriction. The limit only kicks in at migration time.

So, I’d suggest that you check this option " HubSpot Marketplace | Listing your app - HubSpot docs " that can help. Once your app listed/approved, the install cap is removed.

In the meantime, let me check internally if there is something else we can do for this.

Also, let’s consult our Top Experts: Hi @Anton, @zach_threadint and @SteveHTM do you have any tips to help @son.nguyen.developer, please?

Thanks so much and have a wonderful day!
Bérangère

5

Hi @son.nguyen.developer, I hope that you are well!

I wanted to follow up on this. After checking with our team, I can confirm that we aren’t able to make exceptions regarding the app install limits.

Before we can provide a recommendation for the best path forward for migrating your app, we need some additional information. I’ll follow up with you directly with next steps.

Thanks,
Bérangère

8

Hi @Berangere
I understood your point. Please let me know if you need any additional information related for recommendation path.
Thank you very much @Berangere

Best regards,
Son

9

Hey @son.nguyen.developer,

Thanks for reaching back out here! I see that @Berangere has reached out to you directly via DM. She included followup instructions on where to submit your info and where to reach out if you have any follow up questions on the matter.

Hope this helps point you in the right direction!

Best,

Sam, Community Manager