Skip to main content
This reference article pertains to legacy apps. For the latest scopes reference for apps built on the new developer platform, check out this article instead.
Scopes provide access to a specific set of HubSpot API endpoints and the associated data from a HubSpot account. If you created a private app, you can specify which scopes your app has access to in your private app settings. If you’re developing a public app, you’ll configure both required and optional scopes that users who install your app will be prompted to authorize via the app’s install URL.

​
Find required scopes for an endpoint

Any scopes required to make a request to a specific endpoint will be listed under the Required Scopes section in a reference article or the expandable Scope requirements section of the corresponding API guide. These API resources can be accessed by navigating to the APIs section of HubSpot’s developer documentation, then drilling down into the specific API you need (e.g., the contacts API guide or the retrieve contacts reference page).
Find scope requirements in API guide

​
List of available scopes

Access to specific APIs or endpoints depends on HubSpot account tier. You can find a full list of available scopes and accessible endpoints in the table below.
Last modified on July 15, 2026