Install Button for Marketplace app submission

[notabot]

I'm trying to publish my app to the HubSpot marketplace. As part of the process, I need to select an "Install Button URL" from a list generated by HubSpot. All these Install Button options are hosted on HubSpot (https://app.hubspot.com/oauth/authorize), which uses a `redirect_url` query parameter populated from OAuth
redirect URLs allowlisted in the OAuth settings of my app. I assume that a user will give consent to the permissions and then be redirected to a redirect URL with a security code to resume the installation.

However, I see apps listed in the Marketplace, such as Gmail, have an "Install button" that navigates users to an arbitrary URL—such as a Chrome extension page for Gmail. Where am I supposed to enter this URL when submitting my app to the marketplace?

[HubDoPete · Accepted solution]

Hi Amir,

The rules for the Marketplace App Install Button changed for Developer Accounts created after 5th March 2025. It is part of HubSpot's new consistent 'App Install Flow"

The Install Button change was included in the Developer Changelog March 2025 Rollup

https://developers.hubspot.com/changelog/march-2025-rollup

Here is the relevant section, best, Pete.

Updated app install flow in the app marketplace

We've updated the process for listing apps in the app marketplace to provide a unified experience for customers. These changes currently only affect developer accounts created after March 5th, 2025. Accounts and apps created prior to this date will still have the previous functionality for the listing process.

Apps in these accounts will no longer be able to set a custom URL for the app's install button, and will instead select a redirect URL from the redirect URLs configured in the app settings.

[Jaycee_Lewis]

Hey @HubDoPete and @zach_threadint! A huge THANK YOU to both of you 🙌 — Jaycee

[zach_threadint]

Hi @notabot 👋

The "Install button URL" input within your HubSpot App Marketplace Listing configuration generally should point to a webpage managed by the app. On this webpage, you could outline installation instructions (including any prerequesites etc.) and your HubSpot App Install URL. Based on my experience, the HubSpot App Marketplace Listing configuration doesn't allow you to use your install URL directly within this "Install button URL" input (at the moment, doing this raises a validation error).

I hope that proves helpful. Please let me know if you have any follow-up questions.

[Jaycee_Lewis]

Hi, @notabot 👋 Welcome to our community! Thanks for the great question. Hey @zach_threadint @Mike_Eastwood @johnelmer, do you have any App Marketplace submission-related experience here? Thank you very much for taking a look! — Jaycee