> ## Documentation Index > Fetch the complete documentation index at: https://developers.hubspot.com/docs/llms.txt > Use this file to discover all available pages before exploring further. --- id: 65e9e85c-96d0-44ec-ab30-453973373be6 --- # Configure user-level access for an app (BETA) > Learn about how to manage user API access in your app using user-level access. export const BetaDisclaimerBanner = () => This functionality is currently in beta. By participating in this beta, you agree to HubSpot's Developer Terms and Developer Beta Terms. Note that the functionality is still under active development and is subject to change based on testing and feedback. ; User-level access is an alternative, more granular option to the account-wide access apps grant to users in your HubSpot account. ## User-level vs. account-level access Account-level access provides a uniform level of access for all users in your HubSpot account, while user-level access links your app's features and API access to the associated per-user permissions in your account. When user-level access is set up, each user that meets your app's configured [scopes](/docs/apps/developer-platform/build-apps/authentication/scopes) that correspond to their [in-app permissions](https://knowledge.hubspot.com/user-management/hubspot-user-permissions-guide) can install the app. If your app should behave differently based on who is using it, then you should opt for user-level access. Otherwise, account-level access remains the right choice for other use-cases such as account-wide automation, or syncing data across many tools in your account. ## Set up user-level access for your app To turn on user-level access for your app, add `isUserLevel: true` to the `config` property in your app's top-level `app-hsmeta.json` [file](/docs/apps/developer-platform/build-apps/app-configuration#app-schema): ```json highlight={7} theme={null} { "uid": "your-app-uid", "type": "app", "config": { "name": "Your App Name", "distribution": "marketplace", "isUserLevel": true, "auth": { "type": "oauth", "redirectUrls": [ "http://localhost:4000/oauth2/hubspot-callback" ] } } } ``` If `isUserLevel` is set to `false` or left unspecified, your app will use account-level access. Once you finish updating your app's configuration and upload your project, any user who installs your app will have their actions annotated with `[User] via [app name]` in HubSpot's app audit logs. **Please note:** existing apps using account-level access cannot currently be migrated to user-level access. You'll need to create a new app with user-level access to leverage this functionality. ## Supported platform features The sections below outline the platform feature support for user-level access. ### Platform features | Feature | Account-level | User-level | | ----------------------------------------------------------------------------------------------------------- | ------------- | -------------------------------------------- | | [APIs](/docs/api-reference/latest/overview) | Yes | Yes ([partial](#api-support)) | | [MCP](/docs/apps/developer-platform/build-apps/integrate-with-the-remote-hubspot-mcp-server) | No | Yes | | [App pages](/docs/apps/developer-platform/add-features/ui-extensions/extension-points/app-pages/overview) | Yes | Yes ([partial](#ui-extension-point-support)) | | [App cards](/docs/apps/developer-platform/add-features/ui-extensions/extension-points/app-cards/overview) | Yes | No | | [App settings](/docs/apps/developer-platform/add-features/ui-extensions/extension-points/create-a-settings-page) | Yes | Yes ([partial](#ui-extension-point-support)) | | [`hubspot.fetch()`](/docs/apps/developer-platform/add-features/ui-extensions/fetching-data#hubspot-fetch) | Yes | Yes | | [UIE hooks](/docs/apps/developer-platform/add-features/ui-extensions/ui-extensions-sdk/hooks) | Yes | Yes | | [Serverless functions](/docs/apps/developer-platform/add-features/serverless-functions/overview) | Yes | Yes | | [Webhooks](/docs/apps/developer-platform/add-features/configure-webhooks) (v3, v4) | Yes | No | | [Custom workflow actions](/docs/apps/developer-platform/add-features/custom-workflow-actions) | Yes | No | | [Agent tools](/docs/apps/developer-platform/add-features/agent-tools/overview) | Yes | No | | [App events](/docs/apps/developer-platform/add-features/app-events/overview) | Yes | No | | [App objects](/docs/apps/developer-platform/add-features/app-objects/overview) | Yes | No | | [CMS](/docs/cms/start-building/introduction/overview) | Yes | No | | [SCIM](/docs/apps/developer-platform/add-features/scim) | Yes | No | All [distribution options](/docs/apps/developer-platform/build-apps/app-configuration#distribution) and [authentication methods](/docs/apps/developer-platform/build-apps/app-configuration#authentication) support user-level access. ### UI extension point support For [app pages](/docs/apps/developer-platform/add-features/ui-extensions/extension-points/app-pages/overview) and [app settings](/docs/apps/developer-platform/add-features/ui-extensions/extension-points/create-a-settings-page), you'll need to set up and manage a separate backend service yourself to provide user-specific functionality and ensure you're not sharing data between individual user installs. ### API support The following REST APIs are currently supported with user-level apps: * [CRM objects](/docs/api-reference/latest/crm/understanding-the-crm) * [CRM properties and property groups](/docs/api-reference/latest/crm/properties/guide) * [CRM object schemas](/docs/api-reference/latest/crm/objects/schemas/guide) * [Scheduler](/docs/api-reference/latest/scheduler/guide) * [Sequences](/docs/api-reference/2026-09-beta/automation/sequences/guide)