App Marketplace listing requirements

App listing submissions are manually reviewed by HubSpot's App Partner team and will be rejected if they do not meet the criteria outlined below. Once your app meets these requirements, you can build your app listing from within your app developer account by navigating to App Marketplace > Listings > Create listing.

Minimum requirements

  • Single HubSpot app ID: your app must authorize API requests with the public HubSpot app ID (and OAuth client ID) associated with your app listing.
    • A listing must not redirect to a different public or private app.
    • Your listed public app must not require another public or private app to function. 
  • OAuth: your app must use OAuth as its sole authorization method. Learn more about working with OAuth.
  • Installs: your app must have at least three active, unique installs. You won’t be able to submit your app listing without this.
  • Webhooks: your app must use webhooks to support privacy-compliant contact deletions. OAuth is required to access the Webhooks API.
  • Scopes: you must only request scopes your app needs. Review your scopes and make sure you’re not asking for unnecessary access. Apps that do this tend to have better conversion rates.
    • Your app must have the scopes it requires in the app's settings. These settings can be found in the developer account that manages your app.
  • Terms: you must review and agree to the terms in HubSpot's App Partner Program Agreement. This protects you, HubSpot, and our shared customers. You won’t be able to submit your app listing without completing this step. 

Brand requirements

  • Your app and its associated collateral (documentation, landing pages, etc.) must meet HubSpot’s Branding Guidelines. For example, capitalize the “S” in “HubSpot” any time you’re referring to HubSpot.
  • Your app and its associated collateral (documentation, landing pages, etc.) must not infringe HubSpot’s Trademark Usage Guidelines. For example, do not combine HubSpot's name (including “Hub” and “HubSpot”) with your app name or logo.

Listing requirements

Once you’ve met the minimum requirements, you can submit your app listing. When submitting your app listing, you must completely and accurately fill out all information. These fields are particularly important and failure to meet these requirements will cause your listing to be set to Draft mode only:

  • The content of your listing should be specific to the integration as opposed to general product information. It should contain information about the value customers can expect specifically from downloading and using this integration. Good examples include: Aircall, CloudFiles, Reveal.
  • A link to a publicly available (no sign-in, no paywall) Setup Documentation specific to your HubSpot integration. 
    • Your Setup Guide cannot simply be your homepage or a general knowledge base.
    • Instead, it must contain the steps to install and configure the integration.
    • For an example, check out the OrgChartHub setup guide.
  • Include a relevant Install button URL that brings customers to a page where they can easily connect your app with HubSpot.
  • URLs for your app’s support resources (support website, HubSpot community forum, case study) must be live, up-to-date, and publicly available.
  • URLs for your app’s Terms of Service and Privacy Policy must be live and up-to-date.
  • All URL fields have a limit of 250 characters.
  • Shared data, which lets users know how information will flow between your app and HubSpot, must be accurate, up-to-date, and reflect the scopes your app requests.
    • All objects selected in your OAuth scopes should be documented in the Shared data table.
    • If your app is requesting both read and write object scopes, the data sync should be advertised as bi-directional for these specific objects.
  • Your App Marketplace listing must contain clear and accurate pricing information.
    • At least one pricing plan relevant to your HubSpot integration, which needs to match the information published on your website.
    • Free pricing plans should only be used for Free forever or Freemium pricing models.
  • You must include at least one support contact method.
  • Follow the guidelines listed here for providing testing credentials for your app listing. 

Review, feedback, and approval

Once you submit your listing, HubSpot will complete an initial review within 10 business days. If any of the information provided is incorrect, misleading, or incomplete, we’ll contact you with that feedback. As stated in the App Marketplace Terms, HubSpot reserves the right to unpublish or refuse publication of your app listing at any time.

Should your app be accepted into the App Marketplace, it will be listed for a maximum of 12 months. After that, your listing must be resubmitted for review and renewal. We’ll reach out with renewal information and next steps 60 days before your listing is set to expire.

Rewards for Listed App Partners

  • Dedicated HubSpot App Marketplace listing
  • Priority access to developer support through a dedicated support alias
  • Developer community resources, including webinars, forums, and more
  • Curated marketing resources, including PR templates and launch guides
  • Discounted INBOUND event sponsorship, booths, and tickets
  • Discounted software through the HubSpot for Startups seed-stage program
  • Monthly newsletter with marketing updates, product releases, and more

Was this article helpful?
This form is used for documentation feedback only. Learn how to get help with HubSpot.