Understand updated app installation flow with the option for partner sign in

​

Understand limits and considerations

• Apps that have opted into using the updated install flow early. After April 5, 2026, it will apply to all apps that make changes in the listing editor.
• Apps listed on the HubSpot Marketplace.
• Customers installing the app for the first time. Existing customers who have already installed the app are not affected.
• Installs initiated from the HubSpot Marketplace. Installs initiated from external websites or the app itself are not affected.
• The option of whether customers need to sign in with an external system to authenticate. OAuth authentication itself is not affected.
• The app’s installation process once you publish changes in the listing editor. Until then, the app’s current installation process will not change.

​

Opt into the updated install flow early

1. If you are using development tools in a standard HubSpot account, navigate to Development. In the left sidebar menu, click App Listings.
2. If you are using a legacy developer account, navigate to Marketplace > App Listings.
3. Hover over an app, then click the More dropdown menu and select Edit draft.

4. In the Listing info section, click Enable seamless install flow.

5. In the dialog box, select the checkbox that shows you understand you can’t return to the previous install flow, then click Enable seamless install.
6. In the Listing info section of the listing editor, click the Install button URL dropdown menu and select a URL.
7. In the Sign-in configuration section, select whether the app will include partner sign in.

​

Understand the install flow without partner sign in

​

Developer perspective

// Helper function 
function getQueryParam(param) {
    const params = new URLSearchParams(window.location.search);
    return params.get(param);
}

const code = getQueryParam('code');
const returnUrl = getQueryParam('returnUrl');

​

Customer perspective

1. In your HubSpot account, click the marketplace icon in the top navigation bar, then select HubSpot Marketplace.
2. Click an app card.
3. In the top left, click Install.
4. In the dialog box, review the app’s requirements, then select the checkbox and click Connect app.

5. Once the app is installed, you can start using the app:
   • Click Explore app features to start from the Feature Discovery section of the app overview page in your Connected Apps settings.
   • Click Customize app cards to start customizing the app’s app cards.
   • Click the X in the top right to return to the app listing page.

​

Understand the install flow with partner sign in

​

Developer perspective

https://www.myinstallserver.com/install?returnUrl=https://hubspotreturnurl/install-success&step=authorize

// Helper function 
function getQueryParam(param) {
    const params = new URLSearchParams(window.location.search);
    return params.get(param);
}
const step = getQueryParam('step');
const returnUrl = getQueryParam('returnUrl');

function generateStateParameter() {
    const array = new Uint8Array(32);
    crypto.getRandomValues(array);
    return Array.from(array, byte => byte.toString(16).padStart(2, '0')).join('');
}
const state = generateStateParameter();

const returnUrlObj = new URL(returnUrl);
returnUrlObj.searchParams.set('state', state);
// Redirect back to HubSpot
window.location.href = returnUrlObj.toString();
// e.g. returnUrlObj.toString() = "https://www.hubspotReturnUrl.com?state=123abc"
// or returnUrlObj.toString() = "https://www.hubspotReturnUrl.com?someHubSpotParam=returnUrlParam&state=123abc"
</Step>
<Step title="Receive final installation request">
 Your install URL endpoint receives a request with these parameters: 
 - `step=finalize`: indication that this is the final step in the installation process.
 - `code`: the OAuth code HubSpot uses to generate your tokens. 
 - `state`: the secure token you generated in Step 3.
 - `returnUrl`: URL used to direct the user back to HubSpot after the authentication process completes.  

 For example: 

  </Step>
  <Step title="Get parameters from the URL">
  - Get the `step`, `code`, `state`, and `returnUrl` parameters from the URL. 
  ```javascript
// Helper function 
function getQueryParam(param) {
    const params = new URLSearchParams(window.location.search);
    return params.get(param);
}

const step = getQueryParam('step');
const code = getQueryParam('code');
const state = getQueryParam('state');
const returnUrl = getQueryParam('returnUrl');

​

Customer perspective

1. In your HubSpot account, click the marketplace icon in the top navigation bar, then select HubSpot Marketplace.
2. Click an app card.
3. In the top left, click Install.
4. In the dialog box, click Sign in to sign up or log in to the app.
5. In the new window, finish the app’s sign up / log in process externally.

6. After being redirected back to HubSpot, review the app’s requirements, then select the checkbox and click Connect app.

7. Once the app is installed, you can start using the app:
   • Click Explore app features to start from the Feature Discovery section of the app overview page in your Connected Apps settings.
   • Click Customize app cards to start customizing the app’s app cards.
   • Click the X in the top right to return the app listing page.

​

Preview the install flow

1. If you’re using development tools in a standard HubSpot account, navigate to Development. In the left sidebar menu, click App Listings.
2. If you’re using a legacy developer account, navigate to Marketplace > App Listings.
3. Hover over an app, then click the More dropdown menu and select Edit draft.
4. In the top right, click Preview.
5. Run through a test version of the installation process. The test won’t install the app or trigger OAuth authentication.