Skip to content

Resolve a 'Request for Integration Permissions' error

Last updated: April 17, 2024

Available with any of the following subscriptions, except where noted:

All products and plans

When you attempt to connect an integration to HubSpot, you may encounter a Request for Integration Permissions error. These errors occur because certain integrations require specific user roles and/or specific account-wide tools in order to connect to HubSpot.

Common errors

The following errors may appear for a user when they try and connect an integration. Review the troubleshooting steps associated with the error for details on how to address the issue.

"Couldn't complete the connection: Authorization failed because the provided scopes are insufficient. Please contact the app developer."

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.

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."

Users will encounter this error if one of the following scenarios occurs:

  • 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 include 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 would occur if the scope is configured in an app's settings as an optional scope, but the provided install URL is /authorize?client_id=123&redirect_uri=xyz&
To resolve this error, app developers should ensure they've correctly configured scopes as conditionally required or optional in their app settings, then confirm 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."

The HubSpot user attempting to connect the integration does not have the user roles or permissions required to authorize the required scopes requested by the integration.

To resolve this error, the user connecting the integration must have App Marketplace permissions, which ensures they can connect and install apps from the HubSpot App Marketplace for your HubSpot account. If granting the user with these permissions does not work you will need to give them Super Admin permissions to resolve the error.

"This account doesn't have access to some HubSpot features that are required by this integration. Please contact the integrator."

The HubSpot account the integration is connecting to does not have the tool(s) corresponding to the required scopes requested by the integration. For example, a HubSpot account with a Marketing Hub Starter subscription attempting to connect to an integration that requires the workflows tool.

To resolve this error, the HubSpot account must be upgraded to a subscription that has access to the required tool(s). If you want to upgrade your account, reach out to the third party integrator to determine which subscription is required to connect their integration.

Was this article helpful?
This form is used for documentation feedback only. Learn how to get help with HubSpot.