> ## 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: f3011044-1352-4940-b002-84555f2dd80a --- # Scopes > Learn about the different scopes available for apps in HubSpot. export const FilterTable = ({children, placeholder = "Search", className = "", ignoreColumns = []}) => { const [searchTerm, setSearchTerm] = useState(''); const [originalTable, setOriginalTable] = useState(null); const [filteredRowsCount, setFilteredRowsCount] = useState(0); const tableRef = useRef(null); useEffect(() => { if (tableRef.current) { const table = tableRef.current.querySelector('table'); if (table) { setOriginalTable(table.cloneNode(true)); } } }, [children]); useEffect(() => { if (!originalTable || !tableRef.current) return; const table = tableRef.current.querySelector('table'); if (!table) return; const tbody = table.querySelector('tbody'); if (!tbody) return; const originalRows = Array.from(originalTable.querySelectorAll('tbody tr')); const headerRow = originalTable.querySelector('thead tr'); const headers = Array.from(headerRow.querySelectorAll('th')).map(th => th.textContent.trim()); const ignoreIndices = ignoreColumns.map(colName => headers.findIndex(header => header === colName)).filter(index => index !== -1); const filteredRows = searchTerm ? originalRows.filter(row => { const cells = Array.from(row.querySelectorAll('td')); const searchableText = cells.filter((cell, index) => !ignoreIndices.includes(index)).map(cell => cell.textContent).join(' ').toLowerCase(); return searchableText.includes(searchTerm.toLowerCase()); }) : originalRows; setFilteredRowsCount(filteredRows.length); tbody.innerHTML = ''; if (filteredRows.length === 0 && searchTerm) { const emptyRow = document.createElement('tr'); const emptyCell = document.createElement('td'); emptyCell.colSpan = headers.length; emptyCell.className = 'filter-table-empty-state'; emptyCell.innerHTML = `No results found for ${searchTerm}`; emptyRow.appendChild(emptyCell); tbody.appendChild(emptyRow); } else { filteredRows.forEach(row => { tbody.appendChild(row.cloneNode(true)); }); } const thead = table.querySelector('thead'); if (thead) { const headerCells = thead.querySelectorAll('th'); headerCells.forEach(th => { if (searchTerm && filteredRows.length === 0) { th.style.color = '#CCCCCC'; th.style.display = 'none'; } else { th.style.color = ''; th.style.display = 'table-cell'; } }); } }, [searchTerm, originalTable, ignoreColumns]); return
setSearchTerm(e.target.value)} maxLength={75} className="filter-table-input" />
{children}
; }; Scopes provide access to a specific set of HubSpot API endpoints and the associated data from a HubSpot account. ## 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](/getting-started/introduction) of HubSpot's developer documentation, then drilling down into the specific API you need (e.g., the [contacts API guide](/api-reference/latest/crm/objects/contacts/guide)). ## App scope types When you specify the scopes within the `auth` property of your `app-hsmeta.json` [configuration file](/apps/developer-platform/build-apps/app-configuration#authentication), there are three different scope types available for you to configure. You must specify the scopes your app will require for installation, but you can also specify two other scope types: conditionally required scopes and optional scopes. * **Required scopes:** scopes that must be authorized by the user and must be present in the `scope` query parameter in your app's install URL for successful installation. * **Conditionally required scopes:** scopes that must be authorized by the user only if they're present in the `scope` query parameter in your app's install URL for successful installation. * This scope type allows you to be flexible and provide a separate install URL for tiered features or scopes that are only required when users enable certain features in your app. For example, you could offer two install URLs to your users: one install URL could include the conditionally required scope in the `scope` query parameter for users with access to a feature, while another install URL omits that scope in the `scope` query parameter for users without access. * If a conditionally required scope is present in your app install URL and a user without access to the associated feature attempts to install your app using that URL, the installation will fail. * **Optional scopes:** scopes that are not required to successfully install your app. These scopes are specified in the `optional_scope` query parameter in your app's install URL. For example, if you want your app to be able to fetch [custom object](/api-reference/latest/crm/objects/custom-objects/guide) data (which is only available to *Enterprise* HubSpot accounts), you could add the `crm.objects.custom.read` scope as an optional scope. Then, if an account has access to the custom objects, the scope will be authorized. Otherwise, they’ll still be able to install the app without the custom objects scope. ## 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. | **Scope** | **Description** | | ---------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `account-info.security.read` | Includes access to [account activity logs](/api-reference/latest/account/audit-logs/guide) and other account security information.

Available to all accounts. | | `analytics.behavioral_events.send` | Includes access to send [custom event occurrences](/api-reference/latest/events/send-event-data/guide).

Available to *Professional* or *Enterprise* accounts only. | | `automation` | Grants access to create and retrieve [custom workflow actions](/api-reference/latest/automation/workflow-actions/custom-action-builder), and usage of the [v4 workflow APIs](/api-reference/legacy/automation/workflows/guide).

Available to *Professional* or *Enterprise* accounts only. | | `automation.sequences.enrollments.write` | Enroll contacts in a [sequence](/api-reference/latest/automation/sequences/guide#enroll-a-contact-in-a-sequence).

Available to ***Sales Hub*** or ***Service Hub*** *Professional* or *Enterprise* accounts only. | | `automation.sequences.read` | View details about [sequences](/api-reference/latest/automation/sequences/guide).

Available to ***Sales Hub*** or ***Service Hub*** *Professional* or *Enterprise* accounts only. | | `behavioral_events.event_definitions.read_write` | Create, read, update, or delete [custom events](/api-reference/latest/events/define-events/guide). This includes behavioral event properties.

***Marketing Hub*** *Enterprise* accounts only. | | `business_units_view.read` | View [brand data](/api-reference/latest/account/brands/guide), including logo information. Note that the [brands functionality](https://knowledge.hubspot.com/branding/manage-your-brands-with-hubspot-brands) is the successor to business units.

Available to accounts with the [Brands Add-on](https://www.hubspot.com/brands) only. | | `business-intelligence` | Grants access to the [legacy v2 reporting endpoints](/api-reference/legacy/deprecated-apis).

Available to all accounts. | | `cms.domains.read` | List [connected domains](/api-reference/latest/cms/domains/guide) in an account.

Available to all accounts. | | `cms.domains.write` | Create, update, and delete [connected domains](/api-reference/latest/cms/domains/guide).

Available to all accounts. | | `cms.functions.read` | View all [Content Hub serverless functions](/cms/start-building/features/serverless-functions/overview), any related secrets, and function execution results.

Available to ***Content Hub** Enterprise* accounts only. | | `cms.functions.write` | Grants access to write [Content Hub serverless functions](/cms/start-building/features/serverless-functions/overview) and secrets.

Available to ***Content Hub** Enterprise* accounts only. | | `cms.knowledge_base.articles.read` | View details about knowledge articles using the [GraphQL API](/cms/start-building/features/data-driven-content/graphql/query-hubspot-data-using-graphql#use-a-graphql-query-in-an-api-request).

Available to ***Service Hub*** *Professional* or *Enterprise* accounts only. | | `cms.membership.access_groups.read` | View [membership access groups](/cms/start-building/features/memberships/overview) and their definitions.

Available to ***Service Hub*** or ***Content Hub** Professional* or *Enterprise* accounts only. | | `cms.membership.access_groups.write` | Create, edit, and delete [membership access groups](/cms/start-building/features/memberships/overview).

Available to ***Service Hub*** or ***Content Hub** Professional* or *Enterprise* accounts only. | | `collector.graphql_query.execute` | Query data from your HubSpot account using the [GraphQL API endpoint](/cms/start-building/features/data-driven-content/graphql/query-hubspot-data-using-graphql#use-a-graphql-query-in-an-api-request)

Available to ***CMS Hub*** *Professional* or *Enterprise* accounts only. | | `collector.graphql_schema.read` | Perform [introspection queries](/cms/start-building/features/data-driven-content/graphql/query-hubspot-data-using-graphql#use-a-graphql-query-in-an-api-request) via GraphQL application clients such as [GraphiQL](/cms/start-building/features/data-driven-content/graphql/query-hubspot-data-using-graphql#test-and-run-queries-interactively-using-graphiql).

Available to ***CMS Hub** Professional* or *Enterprise* accounts only. | | `communication_preferences.read` | View details of your contacts' [subscription preferences](/api-reference/legacy/communication-preferences/guide).

Available to all accounts. | | `communication_preferences.read_write` | Provides access to subscribe or unsubscribe contacts to your [subscription types](/api-reference/legacy/communication-preferences/guide), as well as retrieve subscription preferences for your contacts.

Available to all accounts. | | `communication_preferences.statuses.batch.read` | Allows you to [batch retrieve contacts](/api-reference/legacy/communication-preferences/guide#using-batch-subscription-endpoints) based on their subscription status.

Available to ***Marketing Hub*** *Enterprise* accounts only. | | `communication_preferences.statuses.batch.write` | Allows you to [batch update](/api-reference/legacy/communication-preferences/guide#using-batch-subscription-endpoints) the subscription status of multiple contacts.

Available to ***Marketing Hub*** *Enterprise* accounts only. | | `communication_preferences.write` | [Subscribe or unsubscribe](/api-reference/legacy/communication-preferences/guide#update-subscription-preferences-for-a-specific-contact) contacts to your subscription types.

Available to all accounts. | | `content` | Grants access to content APIs, including [website pages](/api-reference/latest/cms/pages/website-pages/get-website-pages), [landing pages](/api-reference/latest/cms/pages/landing-pages/get-landing-pages), [marketing email](/api-reference/latest/marketing/marketing-emails/guide), and [blog](/api-reference/latest/cms/blogs/posts/guide) APIs.

Available to ***CMS Hub*** *Professional* or *Enterprise*, or ***Marketing Hub*** *Professional* or *Enterprise* accounts only. | | `conversations.read` | View details about [actors](/api-reference/latest/conversations/guide#get-actors), [messages](/api-reference/latest/conversations/guide#retrieve-messages), and [threads](/api-reference/latest/conversations/guide#retrieve-threads) in the conversations inbox.

Available to all accounts. | | `conversations.visitor_identification.tokens.create` | Fetch [identification tokens](/api-reference/legacy/conversations/visitor-identification/guide) for authenticated website visitors interacting with the HubSpot chat widget.

Available to *Professional* or *Enterprise* accounts only. | | `conversations.write` | Create and manage [threads and messages](/api-reference/latest/conversations/guide#threads-%26-messages) in the conversations inbox.

Available to all accounts. | | `conversations.custom_channels.read` | View details about [custom channels](/api-reference/latest/conversations/guide) for connected inboxes and help desk.

Available to ***Sales Hub*** or ***Service Hub*** *Enterprise* accounts only. | | `conversations.custom_channels.write` | Manage [custom channels](/api-reference/latest/conversations/guide) for connected inboxes and help desk.

Available to ***Sales Hub*** or ***Service Hub*** *Enterprise* accounts only. | | `crm.export` | [Export records](/api-reference/latest/crm/exports/guide) from your CRM for all CRM data types.

Available to all accounts. | | `crm.import` | Allows you to [import records](/api-reference/latest/crm/imports/guide#scope-requirements) into your CRM. This includes creating new records or modifying any of your existing records for all CRM data types (contacts, companies, deals, tickets, etc).

Available to all accounts. | | `crm.dealsplits.read_write` | Create or retrieve [deal splits](/api-reference/latest/crm/objects/deal-splits/guide) on a deal.

Available to ***Sales Hub*** *Enterprise* accounts only. | | `crm.lists.read` | View details about contact [lists](/api-reference/latest/crm/lists/guide#retrieve-lists).

Available to all accounts. | | `crm.lists.write` | Create, delete, or make changes to contact [lists](/api-reference/latest/crm/lists/guide#create-a-list).

Available to all accounts. | | `crm.objects.appointments.read` | View properties and other details about [appointments](/api-reference/latest/crm/objects/appointments/get-appointments).

Available to all accounts. | | `crm.objects.appointments.sensitive.read` | View [Sensitive Data](/api-reference/latest/crm/properties/sensitive-data#sensitive-scopes) properties for appointments.

Available to *Enterprise* accounts only. | | `crm.objects.appointments.sensitive.write` | Edit [Sensitive Data](/api-reference/latest/crm/properties/sensitive-data#sensitive-scopes) properties and values for appointments.

Available to *Enterprise* accounts only. | | `crm.objects.appointments.write` | Create, delete, or make changes to [appointments](/api-reference/latest/crm/objects/appointments/create-appointment).

Available to all accounts. | | `crm.objects.carts.read` | View properties and other details about [carts](/api-reference/latest/crm/objects/carts/guide#retrieve-carts).

Available to all accounts. | | `crm.objects.carts.write` | Create, delete, or make changes to [carts](/api-reference/latest/crm/objects/carts/guide#create-carts).

Available to all accounts. | | `crm.objects.commercepayments.read` | View details about commerce [payments](/api-reference/latest/crm/objects/commerce-payments/guide).

Available to *Starter* accounts only. | | `crm.objects.companies.highly_sensitive.read` | View [Highly Sensitive Data](/api-reference/latest/crm/properties/sensitive-data#highly-sensitive-scopes) properties for companies.

Available to *Enterprise* accounts only. | | `crm.objects.companies.highly_sensitive.write` | Edit [Highly Sensitive Data](/api-reference/latest/crm/properties/sensitive-data#highly-sensitive-scopes) properties and values for companies.

Available to *Enterprise* accounts only. | | `crm.objects.companies.read` | View properties and other details about [companies](/api-reference/latest/crm/objects/companies/guide#retrieve-companies).

Available to all accounts. | | `crm.objects.companies.sensitive.read` | View [Sensitive Data](/api-reference/latest/crm/properties/sensitive-data#sensitive-scopes) properties for companies.

Available to *Enterprise* accounts only. | | `crm.objects.companies.sensitive.write` | Edit [Sensitive Data](/api-reference/latest/crm/properties/sensitive-data#sensitive-scopes) properties and values for companies.

Available to *Enterprise* accounts only. | | `crm.objects.companies.write` | View properties and create, delete, or make changes to [companies](/api-reference/latest/crm/objects/companies/guide#create-companies).

Available to all accounts. | | `crm.objects.contacts.highly_sensitive.read` | View [Highly Sensitive Data](/api-reference/latest/crm/properties/sensitive-data#highly-sensitive-scopes) properties for contacts.

Available to *Enterprise* accounts only. | | `crm.objects.contacts.highly_sensitive.write` | Edit [Highly Sensitive Data](/api-reference/latest/crm/properties/sensitive-data#highly-sensitive-scopes) properties and values for contacts.

Available to *Enterprise* accounts only. | | `crm.objects.contacts.read` | View properties and other details about [contacts](/api-reference/latest/crm/objects/contacts/guide#retrieve-contacts).

Available to all accounts. | | `crm.objects.contacts.sensitive.read` | View [Sensitive Data](/api-reference/latest/crm/properties/sensitive-data#sensitive-scopes) properties for contacts.

Available to *Enterprise* accounts only. | | `crm.objects.contacts.sensitive.write` | Edit [Sensitive Data](/api-reference/latest/crm/properties/sensitive-data#sensitive-scopes) properties and values for contacts.

Available to *Enterprise* accounts only. | | `crm.objects.contacts.write` | Create, delete, and make changes to [contacts](/api-reference/latest/crm/objects/contacts/guide#create-contacts).

Available to all accounts. | | `crm.objects.courses.read` | View details about [courses](/api-reference/latest/crm/objects/courses/get-courses).

Available to all accounts. | | `crm.objects.courses.write` | Create, delete, or make changes to [courses](/api-reference/latest/crm/objects/courses/create-course).

Available to all accounts. | | `crm.objects.custom.highly_sensitive.read` | View [Highly Sensitive Data](/api-reference/latest/crm/properties/sensitive-data#highly-sensitive-scopes) properties for custom objects.

Available to *Enterprise* accounts only. | | `crm.objects.custom.highly_sensitive.write` | Edit [Highly Sensitive Data](/api-reference/latest/crm/properties/sensitive-data#highly-sensitive-scopes) properties and values for custom objects.

Available to *Enterprise* accounts only. | | `crm.objects.custom.read` | View details about [custom objects](/api-reference/latest/crm/objects/custom-objects/guide#retrieve-custom-object-records).

Available to *Enterprise* accounts only. | | `crm.objects.custom.sensitive.read` | View [Sensitive Data](/api-reference/latest/crm/properties/sensitive-data#sensitive-scopes) properties for custom objects.

Available to *Enterprise* accounts only. | | `crm.objects.custom.sensitive.write` | Edit [Sensitive Data](/api-reference/latest/crm/properties/sensitive-data#sensitive-scopes) properties and values for custom objects.

Available to *Enterprise* accounts only. | | `crm.objects.custom.write` | Create, delete, or make changes to [custom objects](/api-reference/latest/crm/objects/custom-objects/guide#create-a-custom-object).

Available to *Enterprise* accounts only. | | `crm.objects.deals.highly_sensitive.read` | View [Highly Sensitive Data](/api-reference/latest/crm/properties/sensitive-data#highly-sensitive-scopes) properties for deals.

Available to *Enterprise* accounts only. | | `crm.objects.deals.highly_sensitive.write` | Edit [Highly Sensitive Data](/api-reference/latest/crm/properties/sensitive-data#highly-sensitive-scopes) properties and values for deals.

Available to *Enterprise* accounts only. | | `crm.objects.deals.read` | View properties and other details about [deals](/api-reference/latest/crm/objects/deals/guide#retrieve-deals).

Available to all accounts. | | `crm.objects.deals.sensitive.read` | View [Sensitive Data](/api-reference/latest/crm/properties/sensitive-data#sensitive-scopes) properties for deals.

Available to *Enterprise* accounts only. | | `crm.objects.deals.sensitive.write` | Edit [Sensitive Data](/api-reference/latest/crm/properties/sensitive-data#sensitive-scopes) properties and values for deals.

Available to *Enterprise* accounts only. | | `crm.objects.deals.write` | Create, delete, or make changes to [deals](/api-reference/latest/crm/objects/deals/guide#create-deals).

Available to all accounts. | | `crm.objects.feedback_submission.read` | View details about submissions to any of your [feedback surveys](/api-reference/latest/crm/objects/feedback-submissions/guide#retrieve-survey-responses).

Available to ***Service Hub*** *Professional* or *Enterprise* accounts only. | | `crm.objects.goals.read` | View all [goals](/api-reference/latest/crm/objects/goals/guide#retrieve-goals).

Available to ***Sales Hub*** *Starter*, *Professional*, or *Enterprise* accounts only. | | `crm.objects.invoices.read` | View details about [invoices](/api-reference/latest/crm/objects/invoices/guide#retrieve-invoices).

Available to all accounts. | | `crm.objects.leads.read` | View properties and other details about [leads](/api-reference/latest/crm/objects/leads/guide#retrieve-leads).

Available to ***Sales Hub** Professional* or *Enterprise* accounts only. | | `crm.objects.leads.write` | Create, delete, or make changes to [leads](/api-reference/latest/crm/objects/leads/guide#create-leads).

Available to ***Sales Hub*** *Professional* or *Enterprise* accounts only. | | `crm.objects.line_items.read` | View properties and other details about [line items](/api-reference/latest/crm/objects/line-items/guide#retrieve-a-line-item).

Available to all accounts. | | `crm.objects.line_items.write` | Create, delete, or make changes to [line items](/api-reference/latest/crm/objects/line-items/guide#create-a-line-item).

Available to all accounts. | | `crm.objects.listings.read` | View properties and other details about [listings](/api-reference/latest/crm/objects/listings/get-listings).

Available to all accounts. | | `crm.objects.listings.write` | Create, delete, or make changes to [listings](/api-reference/latest/crm/objects/listings/create-listing).

Available to all accounts. | | `crm.objects.marketing_events.read` | View details about [marketing events](/api-reference/latest/marketing/marketing-events/guide#get-event-details).

Available to all accounts. | | `crm.objects.marketing_events.write` | Create, delete, or make changes to [marketing events](/api-reference/latest/marketing/marketing-events/guide#create-an-event).

Available to all accounts. | | `crm.objects.orders.read` | View properties and other details about [orders](/api-reference/latest/crm/objects/orders/guide).

Available to all accounts. | | `crm.objects.orders.write` | Create, delete, or make changes to [orders](/api-reference/latest/crm/objects/orders/guide).

Available to all accounts. | | `crm.objects.owners.read` | View details about users [assigned to a CRM record](/api-reference/latest/crm/owners/guide#retrieve-a-list-of-owners).

Available to all accounts. | | `crm.objects.partner-clients.read` | View details about [partner clients](/api-reference/latest/crm/objects/partner-clients/get-partner-clients) objects.

Available to all accounts. | | `crm.objects.partner-clients.write` | Create, delete, or make changes to [partner clients](/api-reference/latest/crm/objects/partner-clients/update-partner-client) objects.

Available to all accounts. | | `crm.objects.partner-services.read` | View details about [partner service](/api-reference/latest/crm/objects/partner-services/get-partner-services) objects.

Available to all accounts. | | `crm.objects.partner-services.write` | Create, delete, or make changes to [partner service](/api-reference/latest/crm/objects/partner-services/update-partner-service) objects.

Available to all accounts. | | `crm.objects.quotes.read` | View properties and other details about [quotes and quote templates](/api-reference/latest/crm/objects/quotes/get-quotes).

Available to all accounts. | | `crm.objects.quotes.write` | Create, delete, or make changes to [quotes](/api-reference/latest/crm/objects/quotes/guide) (including [legacy quotes](/api-reference/legacy/crm/objects/quotes/guide)).

Available to all accounts. | | `crm.objects.services.read` | View properties and other details about [services](/api-reference/latest/crm/objects/services/get-services).

Available to all accounts. | | `crm.objects.services.write` | Create, delete, or make changes to [services](/api-reference/latest/crm/objects/services/create-service).

Available to all accounts. | | `crm.objects.subscriptions.read` | View properties and other details about [commerce subscriptions](/api-reference/latest/crm/objects/commerce-subscriptions/guide).

Available to all accounts. | | `crm.objects.users.read` | View properties and other details about [users](/api-reference/latest/crm/objects/users/guide#retrieve-users).

Available to all accounts. | | `crm.objects.users.write` | Create, delete, or make changes to [users](/api-reference/latest/crm/objects/users/guide#update-users).

Available to all accounts. | | `crm.pipelines.orders.read` | View details about [order pipelines](/api-reference/latest/crm/pipelines/guide).

Available to all accounts. | | `crm.pipelines.orders.write` | Create, delete, or make changes to [order pipelines](/api-reference/latest/crm/pipelines/guide).

Available to all accounts. | | `crm.schemas.appointments.read` | View details about property settings for [appointments](/api-reference/latest/crm/objects/appointments/get-appointments).

Available to all accounts. | | `crm.schemas.appointments.write` | Create, delete, or make changes to property settings for [appointments](/api-reference/latest/crm/objects/appointments/create-appointment)

Available to all accounts. | | `crm.schemas.carts.read` | View details about property settings for [carts](/api-reference/latest/crm/objects/carts/guide#retrieve-carts).

Available to all accounts. | | `crm.schemas.carts.write` | Create, delete, or make changes to property settings for [carts](/api-reference/latest/crm/objects/carts/guide#create-carts).

Available to all accounts. | | `crm.schemas.courses.read` | View details about property settings for [courses](/api-reference/latest/crm/objects/courses/get-courses).

Available to all accounts. | | `crm.schemas.courses.write` | Create, delete, or make changes to property settings for [courses](/api-reference/latest/crm/objects/courses/create-course).

Available to all accounts. | | `crm.schemas.commercepayments.read` | View details about property settings for [commerce payments](/api-reference/latest/crm/objects/commerce-payments/guide#properties).

Available to *Starter* accounts only. | | `crm.schemas.companies.read` | View details about property settings for [companies](/api-reference/latest/crm/objects/companies/guide)

Available to all accounts. | | `crm.schemas.companies.write` | Create, delete, or make changes to property settings for [companies](/api-reference/latest/crm/objects/companies/guide).

Available to all accounts. | | `crm.schemas.contacts.read` | View details about property settings for [contacts](/api-reference/latest/crm/objects/contacts/guide).

Available to all accounts. | | `crm.schemas.contacts.write` | Create, delete, or make changes to property settings for [contacts](/api-reference/latest/crm/objects/contacts/guide).

Available to all accounts. | | `crm.schemas.custom.read` | View details about [custom object definitions](/api-reference/latest/crm/objects/custom-objects/guide#properties) in the HubSpot CRM.

Available to *Enterprise* accounts only. | | `crm.schemas.deals.read` | View details about property settings for [deals](/api-reference/latest/crm/objects/deals/guide).

Available to all accounts. | | `crm.schemas.deals.write` | Create, delete, or make changes to property settings for [deals](/api-reference/latest/crm/objects/deals/guide).

Available to all accounts. | | `crm.schemas.invoices.read` | View details about property settings for [invoices](/api-reference/latest/crm/objects/invoices/guide).

Available to all accounts. | | `crm.schemas.invoices.write` | Create, delete, or make changes to property settings for [invoices](/api-reference/latest/crm/objects/invoices/guide#common-properties)

Available to all accounts. | | `crm.schemas.line_items.read` | View details about [line items properties](/api-reference/latest/crm/objects/line-items/guide#line-item-properties).

Available to all accounts. | | `crm.schemas.listings.read` | View details about property settings for [listings](/api-reference/latest/crm/objects/listings/get-listings)

Available to all accounts. | | `crm.schemas.listings.write` | Create, delete, or make changes to property settings for [listings](/api-reference/latest/crm/objects/listings/create-listing)

Available to all accounts. | | `crm.schemas.orders.read` | View details about property settings for [orders](/api-reference/latest/crm/objects/orders/guide#order-properties)

Available to all accounts. | | `crm.schemas.orders.write` | Create, manage, or make changes to property settings for [orders](/api-reference/latest/crm/objects/orders/guide#order-properties)

Available to all accounts. | | `crm.schemas.quotes.read` | View details about [quotes](/api-reference/latest/crm/objects/quotes/guide) and [quotes templates](/api-reference/latest/crm/objects/quotes/guide#quote-templates).

Available to all accounts. | | `crm.schemas.quotes.write` | Create, manage, or make changes to property settings for [quotes](/api-reference/latest/crm/objects/quotes/guide#quote-properties)

Available to all accounts. | | `crm.schemas.services.read` | View details about property settings for [services](/api-reference/latest/crm/objects/services/get-services)

Available to all accounts. | | `crm.schemas.services.write` | Create, manage, or make changes to property settings for [services](/api-reference/latest/crm/objects/services/create-service)

Available to all accounts. | | `crm.schemas.subscriptions.read` | View details about property settings for [commerce subscriptions](/api-reference/latest/crm/objects/commerce-subscriptions/guide).

Available to all accounts. | | `crm.schemas.subscriptions.write` | Create, manage, or make changes to property settings for [commerce subscriptions](/api-reference/latest/crm/objects/commerce-subscriptions/guide).

Available to all accounts. | | `external_integrations.forms.access` | Includes the ability to rename, delete, and clone existing forms when using the [HubSpot WordPress plugin](https://knowledge.hubspot.com/integrations/install-the-hubspot-wordpress-plugin).

Available to all accounts. | | `files` | Access, manage, and upload [files](/api-reference/latest/files/guide) in the HubSpot file manager.

Available to all accounts. | | `files.ui_hidden.read` | Access hidden or deleted [files](/api-reference/latest/files/guide) uploaded to the HubSpot file manager.

Available to all accounts. | | `forms` | Grants access to the [legacy](/api-reference/legacy/marketing/forms/guide) and v3 [forms APIs](/api-reference/legacy/marketing/forms/guide)

Available to all accounts. | | `forms-uploaded-files` | Grants access to the legacy [v1 uploaded form files API](/api-reference/legacy/marketing/forms/guide)

Available to all accounts. | | `hubdb` | Retrieve and manage [HubDB data](/api-reference/legacy/cms/hubdb/guide).

Available to ***CMS Hub*** *Professional* or *Enterprise*, or ***Marketing Hub*** *Professional* or *Enterprise* accounts only. | | `marketing.campaigns.read` | View details about [marketing campaigns](/api-reference/latest/marketing/campaigns/guide) and their associated assets.

Available to ***Marketing Hub*** *Professional* or *Enterprise* accounts only. | | `marketing.campaigns.revenue.read` | View revenue details and deal amounts attributed to a [marketing campaign](/api-reference/latest/marketing/campaigns/guide).

Available to ***Marketing Hub*** *Professional* or *Enterprise* accounts only. | | `marketing.campaigns.write` | Create, update, and delete [marketing campaigns](/api-reference/latest/marketing/campaigns/guide).

Available to ***Marketing Hub*** *Professional* or *Enterprise* accounts only. | | `marketing-email` | Grants access to retrieve and send [marketing emails](/api-reference/latest/marketing/marketing-emails/guide). Publishing marketing emails using this API requires ***Marketing Hub*** *Enterprise*.

Available to all accounts. | | `media_bridge.read` | Grants access to events and objects from the [media bridge API](/api-reference/latest/cms/media-bridge/guide).

Available to all accounts. | | `media_bridge.write` | Grants access to create and update events and objects from the [media bridge API](/api-reference/latest/cms/media-bridge/guide).

Available to all accounts. | | `oauth` | Basic scope required for OAuth. This scope is added by default to all [apps](/apps/developer-platform/build-apps/create-an-app).

Available to all accounts. | | `sales-email-read` | Grants access to read and manage [one-to-one email engagements](/api-reference/latest/crm/activities/emails/guide)

Available to all accounts. | | `scheduler.meetings.meeting-link.read` | Read metadata and booking availability for [meeting links](/api-reference/latest/scheduler/guide)

Available to *Professional* accounts only. | | `settings.billing.write` | Make changes to your [account's billing settings](/api-reference/latest/account/account-information/get-account-details). This includes managing and assigning paid seats for users.

Available to all accounts. | | `settings.currencies.read` | Reads existing exchange rates along with the [current company currency](/api-reference/latest/account/settings/multicurrency/guide#retrieve-account-currencies-and-exchange-rates) associated with your HubSpot account.

Available to all accounts. | | `settings.currencies.write` | Create, update and delete exchange rates along with updating the [company currency](/api-reference/latest/account/settings/multicurrency/guide#add-account-currencies-and-set-exchange-rates) associated with your HubSpot account.

Available to all accounts. | | `settings.users.read` | View details about [account users](/api-reference/latest/account/settings/user-provisioning/users/get-users) and their permissions.

Available to all accounts. | | `settings.users.write` | Manage [users and user permissions](/api-reference/latest/account/settings/user-provisioning/users/create-user) on your HubSpot account. This includes creating new users, assigning permissions and roles, and deleting existing users.

Available to all accounts. | | `settings.users.teams.read` | See details about the [teams in an account](/api-reference/latest/account/settings/user-provisioning/teams/get-teams).

Available to all accounts. | | `settings.users.teams.write` | Assign users to [teams on your HubSpot account](/api-reference/latest/account/settings/user-provisioning/users/update-user).

Available to all accounts. | | `tax_rates.read` | View details about [tax rates](/api-reference/latest/crm/objects/line-items/guide#retrieve-tax-rates) configured in your account.

Available to all accounts. | | `tickets` | Retrieve, manage, or create [tickets](/api-reference/latest/crm/objects/tickets/guide).

Available to all accounts. | | `tickets.highly_sensitive` | Grants access to view and edit [Highly Sensitive Data](/api-reference/latest/crm/properties/sensitive-data#highly-sensitive-scopes) properties and values for tickets.

Available to *Enterprise* accounts only. | | `tickets.sensitive` | Grants access to view and edit [Sensitive Data](/api-reference/latest/crm/properties/sensitive-data#sensitive-scopes) properties and values for tickets.

Available to *Enterprise* accounts only. | | `timeline` | Grants access to manage [legacy timeline events](/api-reference/legacy/crm/extensions/timeline/v1/get-integrations-v1-application-id-timeline-event-event-typeid-event-id) on HubSpot CRM records.

Available to all accounts. | | `transactional-email` | Access and manage [transactional emails](/api-reference/latest/marketing/transactional-emails/guide).

Available to ***Marketing Hub*** *Professional* or *Enterprise* accounts with [Transactional Email Add-on](https://www.hubspot.com/products/marketing/transactional-email) only. | **Please note:** the scopes listed below may appear on certain app configuration pages but do not currently have a corresponding API available: * `cms.knowledge_base.articles.write` * `cms.knowledge_base.articles.publish` * `cms.knowledge_base.settings.read` * `cms.knowledge_base.settings.write` * `ctas.read` ## Deprecated scopes The following scopes are associated with deprecated APIs and should not be used for new app development: * `accounting` * `actions` * `e-commerce` * `integration-sync` * `social`