đ How to Connect HubSpot With a Service Key
This integration lets Gojiberry push your leads and their data into your HubSpot CRM. To connect, Gojiberry needs a HubSpot Service Key with the right permissions (called scopes).
Why a Service Key? HubSpot is retiring private app creation: it is already unavailable for portals created on or after September 28, 2026, and it will be removed for every portal on October 26, 2026 (HubSpot announcement). Service Keys replace them.
1. Create a Service Key in HubSpot
Log into HubSpot with an account that has Super Admin rights.
Click the Settings icon (gear) in the top navigation bar.
In the left sidebar, go to Integrations > Service Keys.
Click Create service key and give it a name, for example "Gojiberry".
2. Add the Scopes
Required (Gojiberry cannot connect without these):
crm.objects.contacts.readandcrm.objects.contacts.write: read, create, and update contactscrm.objects.companies.readandcrm.objects.companies.write: read, create, and update the companies linked to contactscrm.objects.owners.read: list the owners of your HubSpot accountcrm.schemas.contacts.read: read your contact properties for the field mapping
Optional (recommended):
crm.objects.deals.read: needed for deal-stage exclusion rulescrm.lists.read: needed to import HubSpot lists
Use the search bar in the scopes list to find each one quickly, then click Create.
3. Copy the Key and Paste It Into Gojiberry
Copy the key HubSpot shows you and keep it somewhere safe.
In Gojiberry, open Integrations > HubSpot, paste the key into the HubSpot service key field, and save.
If a scope is missing, Gojiberry lists it: add it to your key in HubSpot, then verify again.
đĄ Already Using a Private App Token?
Existing private app tokens keep working, and Gojiberry still accepts them. You only need a Service Key for a new connection, or if your private app is removed.