When you try to connect an integration to HubSpot, you may encounter a Request for Integration Permissions error. This type of error occurs because certain integrations require specific user roles or account-wide tools to connect to HubSpot.
Users may encounter the following errors when attempting to connect an integration. Refer to the troubleshooting steps for guidance on resolving each error.
Couldn't complete the connection: Authorization failed because the provided scopes are insufficient. Please contact the app developer.
What the error means
This error occurs when the app's configuration includes a required scope that's missing from the app's install URL's scope query parameter. Including the required scope in the optional_scope parameter will also trigger the error.
How to resolve the error
To resolve this issue, the app developer must ensure that every install URL includes every required scope they selected in their app configuration.
Couldn't complete the connection: Authorization failed because there is a mismatch between the scopes in the install URL and the app's configured scopes. Please contact the app developer.
What the error means
Users may encounter this error if any of the following scenarios occur:
- An app's install URL includes a conditionally required or optional scope that's not configured in the app's settings.
- A conditionally required scope is included in the
optional_scope query parameter of the app's install URL.
- An optional scope is incorrectly included in the scope parameter of the app's install URL. For example, this error occurs if the
crm.objects.custom.read scope is configured in the app's settings as an optional scope, but the provided install URL is /authorize?client_id=123&redirect_uri=xyz&scope=crm.objects.custom.read.
How to resolve the error
To resolve this error, the app developer should ensure they've correctly configured scopes as either conditionally required or optional in their app settings. Then, confirm that each scope is listed under the associated scope and optional_scope query parameters in the app's install URL.
Couldn't complete the connection. You don’t have permission to connect this integration.
What the error means
The HubSpot user attempting to connect the integration doesn't have the necessary user roles or permissions to authorize the required scopes requested by the integration.
How to resolve the error
To resolve this error, the user connecting the integration must have App Marketplace permissions. These permissions ensure the user can connect and install apps from the HubSpot App Marketplace for your HubSpot account. If granting these permissions doesn't resolve the error, you'll need to assign Super Admin permissions to the user.
This account doesn't have access to some HubSpot features that are required by this integration. Please contact the integrator.
What the error means
The HubSpot account the integration is connecting to doesn't have the tools required for the scopes requested by the integration. For example, a HubSpot account with a Marketing Hub Starter subscription can't connect an integration that requires access to workflows.
How to resolve the error
To resolve this error, the HubSpot account must upgrade to a subscription that has access to the required tools. If you want to upgrade your account, reach out to the app developer to determine which subscription is required to connect their integration.
Integrations
