App Partners can now see HubSpot’s guidelines and requirements for getting an app listed on the App Marketplace in one place.
Last modified: August 22, 2025
App listing submissions are manually reviewed by the HubSpot Ecosystem Quality 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.
Access: the listing must not redirect to a different public or private app or require another public or private app to function.
Uniqueness: your listed public app must be unique. If you have already listed an app and you want to replace it, update the existing app instead of listing a new one.
Use case: each app you create should address a separate use case. Apps with similar functionality and use the same APIs should be consolidated into a single app.
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.
OAuth: your app must use OAuth as its sole authorization method. Learn more about working with OAuth.
Restricted industries: your app must not fit or deliver functionality that would exclusively serve customers within any of HubSpot’s restricted industries.
Restricted functionality: your app cannot use classic CRM cards, as they are no longer supported as of June 16, 2025. Learn more about this announcement on the HubSpot Developer Changelog.
Your app and its associated assets (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 assets (documentation, landing pages, etc.) must not infringe on HubSpot’s Trademark Usage Guidelines. For example, do not combine HubSpot’s name (including “Hub” and “HubSpot”) with your app name or logo.
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.
All URLs in your App Marketplace listing must lead to live, publicly available, and functional pages.
This will be verified using HubSpot’s SEO tools to crawl pages associated with the listing.
To prevent unnecessary delays in the review process, it is strongly recommended to work with your site administrator to add HubSpot’s crawler’s user agent, HubSpot Crawler, to the allow list as an exemption prior to submitting your app listing.
A link to publicly available setup documentation specific to your HubSpot integration.
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:
The pricing plan in the listing must match the pricing information published on your website.
The pricing plan in the listing must only include pricing plans that allow for the usage of your HubSpot integration.
If a pricing plan does not support the integration, it should not be included in your listing.
For example, if you have Plan A and Plan B for your app, but only Plan B can be used with the integration, only the pricing details for Plan B should be included in the listing.
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.
Once you submit your listing, the HubSpot Ecosystem Quality team 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. The entire app review and feedback process should take no more than 60 days from the time feedback is shared. As stated in the App Marketplace Terms, HubSpot reserves the right to unpublish or refuse publication of your app listing at any time.
Please note: you can only submit one app at a time for approval. Any additional apps submitted while the initial app is being processed will automatically be rejected.