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?
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
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.
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
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.
@zach_threadint I don’t quit understand. can you enlighten the procedure to me ? I’m also facing the same problem. I need my integration to be redirect to specify url(help article). But in the forms i am seeing this only ??
Just to clarify, the Install button URL dropdown is populated from your app’s redirect URLs (configured in OAuth settings), HubSpot generates the actual https://app.hubspot.com/oauth/authorize?...&redirect_url=... links from those redirect URLs. So the URL you set up in OAuth settings is the endpoint that receives the install request, for example the Gmail Chrome extension page could itself be the registered OAuth redirect URL, configured to handle the install flow (receiving code, returnUrl, step params) and then redirect back to HubSpot at the end.
There’s no separate free-text field for an arbitrary URL like the Chrome extension page, it’s selected from your allowlisted redirect URLs. If you want an arbitrary landing page (e.g., a Chrome extension install page) to be part of the flow, you’d register that page as one of your app’s OAuth redirect URLs, have it handle the code/returnUrl/step params (please see install flow guide), and ensure it redirects back to returnUrl at the end, that’s how it can look “arbitrary” while still functioning within HubSpot’s OAuth redirect allowlist.
If that’s not what you were after, could you please share the steps you took to get to this page so that we can help you?
Hi @zach_threadint, do you have additional insights to share, please?
Thanks so much and enjoy the day!
Bérangère
This post was created with the assistance of AI tools
Welcome to our community! Thanks for the great question. Hey 
— Jaycee
.
