Action Required for HubSpot Connections to Stay Compliant with Contacts Scope Updates

28 April 2022
KingswaySoft Team

If you have not been made aware yet, HubSpot has announced some recent security enhancements in their APIs which now provide more granular CRM scopes. The new changes essentially split the legacy contacts scope into more specific CRM scopes, which make it possible to choose separate access for contacts, companies, and deals. With this change, you will be able to request only the scopes that are entirely necessary for your app. This provides better security of their API access, and enables a better security control. In doing so, all HubSpot connections that use the deprecated authentication scopes will stop working at some time in June and July time frame.

As a result, all SSIS Integration Toolkit for HubSpot clients will need to operate on the latest version of our HubSpot Connection Manager to avoid any disruption to the integration jobs. To make sure your integration jobs comply with this update, we ask you to please take the following action as soon as possible:

  • First of all, you will need to upgrade to your HubSpot tookit installation to the latest v22.1 release available on our website at
  • Secondly, you need to open the connection manager within Visual Studio, and generate a new token file. Once a new token file is generated using the new version, our software will start using the new scopes.
  • HubSpot Connection Manager - Generate New Token File

Also, we recommend the optional scopes that are provided below, for regular use cases. Please note that this would be based on specific requirements, and more scopes can be added, or certain ones can be removed as necessary. crm.objects.contacts.write crm.objects.companies.write crm.lists.write crm.schemas.companies.write crm.schemas.contacts.write

However, if you need to add more permissions/scopes, please refer to the HubSpot API documentation link here, which can be added while generating the token.

It is worth noting that the above action is required regardless of whether you are using the KingswaySoft app or your own app. If you continue to use the deprecated scopes past the June deadline, your integration jobs that contain our HubSpot components will stop working. It is important to note that you will need to have up-to-date software maintenance in order to upgrade to the most recent version of our software, or the job will fail as well. If you need any assistance with your license subscription or maintenance renewal, please reach out to our client services team.

At KingswaySoft, we are committed to providing the software and support you can trust. We hope this has helped.

Additional links