Scopes for Custom OAuth profiles

To ensure a successful connection between Workato and HubSpot using Custom OAuth profiles, the scopes in Workato must match the scopes configured in your HubSpot app. This additional security measure (opens new window) is required by HubSpot since October 21, 2024. On the Workato side, these scopes are requested during connection setup. Review HubSpot's documentation (opens new window) to learn more about configuring the scopes in your HubSpot OAuth public app's settings.

Recommended scopes

The following section describes all scopes you must add for Workato's HubSpot connector to function properly. You must categorize each scope as either required or optional in HubSpot according to these guidelines. Misconfiguring the scopes can cause HubSpot connection setup errors due to scope mismatches.

Required scopes

The following scope is required for all connections. Assign the scope as required in your HubSpot app settings:

• crm.objects.contacts.read

Optional scopes

The following scopes are optional for all connections. Assign the scopes as optional in your HubSpot app settings:

• accounting
• automation
• business-intelligence
• content
• conversations.visitor_identification.tokens.create
• crm.export
• crm.import
• crm.lists.read
• crm.lists.write
• crm.objects.companies.read
• crm.objects.companies.write
• crm.objects.contacts.write
• crm.objects.custom.read
• crm.objects.custom.write
• crm.objects.deals.read
• crm.objects.deals.write
• crm.objects.marketing_events.read
• crm.objects.marketing_events.write
• crm.objects.owners.read
• crm.objects.quotes.read
• crm.objects.quotes.write
• crm.objects.users.read
• crm.objects.users.write
• crm.schemas.companies.read
• crm.schemas.companies.write
• crm.schemas.contacts.read
• crm.schemas.contacts.write
• crm.schemas.custom.read
• crm.schemas.custom.write*
• crm.schemas.deals.read
• crm.schemas.deals.write
• e-commerce
• files
• files.ui_hidden.read
• forms
• forms-uploaded-files
• hubdb
• integration-sync
• sales-email-read
• settings.billing.write
• settings.users.read
• settings.users.teams.read
• settings.users.teams.write
• settings.users.write
• social
• tickets
• timeline
• transactional-email

AVAILABLE SCOPES

* The crm.schemas.custom.write scope is not available by default. If you require this scope for your integration, you can request access to HubSpot's Custom Objects Schema pilot program (opens new window).