Connecting HubSpot: how to get an access token

For Sales Workshop to create deals and contacts in your HubSpot account, you need to issue a static access token in your own HubSpot account and paste it into the platform's settings. Unlike amoCRM or Bitrix24, this needs no OAuth flow or redirect — just one token you create yourself.

On newer HubSpot accounts this screen is called Service Keys and is reached via "Private Apps" → "Legacy Apps" (HubSpot redirects you there itself) — the steps below follow that exact path.

Step 1. Open Settings

In the top right corner of HubSpot, click the gear icon (Settings).

The Settings icon in HubSpot's top bar.

Step 2. Open Private Apps

In the left settings menu, expand "Integrations" and choose "Private Apps".

HubSpot settings left menu with the Integrations section and the Private Apps item — Integrations → Private Apps in the left settings menu.

Step 3. Get to the key creation screen

On some accounts, HubSpot will say private apps have moved — click "Go to Legacy Apps".

HubSpot notice “Your private apps have moved” with a Go to Legacy Apps button — “Your private apps have moved” → “Go to Legacy Apps”.

Next, HubSpot will say legacy apps aren't available on this account and offer to create a service key instead — click "Create a service key".

Notice “Legacy apps aren't available on this account” with a Create a service key button — “Legacy apps aren't available on this account” → “Create a service key”.

Step 4. Create the service key

On the empty Service Keys page, click "Create service key".

Empty Service Keys page with a Create service key button — The Service Keys page when no keys exist yet — “Create service key”.

In the form that opens, give the key a clear name, e.g. "Sales Workshop", so it's easy to find later.

Create Service Key form with the Name field — The “Create Service Key” form — the Name field.

Step 5. Grant scopes

Click "Add new scope" — without these, HubSpot will reject lead pushes with an access error.

Search for contacts and enable:

crm.objects.contacts.read
crm.objects.contacts.write

Scope search for “contacts” with crm.objects.contacts.read and write checked — Search “contacts” — enable .read and .write.

Search again for deals and enable:

crm.objects.deals.read
crm.objects.deals.write
crm.schemas.deals.read

Scope search for “deals” with crm.objects.deals.read, write and crm.schemas.deals.read checked — Search “deals” — enable .read, .write and crm.schemas.deals.read.

Close the scope picker with "Update".

Step 6. Create the key and copy the token

Click "Create" in the top right corner of the page.

Create Service Key form with the Create button in the top right and the selected scopes below — The “Create” button — creates the key with the selected scopes.

Step 7. Paste the token into Sales Workshop

In Sales Workshop's settings, open the "Leads & CRM" section → the HubSpot card and paste the copied token into the Access Token field.

The HubSpot card in Sales Workshop settings with the Access Token field and the Connect button — The HubSpot card in Sales Workshop — paste the token from step 6 here.

Click "Connect" — Sales Workshop verifies the token right away and starts sending leads to HubSpot.