> ## Documentation Index
> Fetch the complete documentation index at: https://docs.triplesession.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Connect HubSpot with a Private App (Legacy)

> Connect HubSpot to Triple Session AI Coach with a HubSpot Private App access token.

This page covers the token-based HubSpot connection through a HubSpot Private App.

> [!NOTE]
>
> The recommended way to connect is **OAuth**: click **Connect HubSpot** and approve access in HubSpot, with no token to copy. OAuth also enables HubSpot App Cards and task creation. See [Connect HubSpot CRM](https://docs.triplesession.com/crm/connect-hubspot.md), which also explains how to migrate a Private App connection to OAuth.

## Prerequisites

Before connecting, make sure you have:

* **HubSpot admin access** — required to create a private app in HubSpot.
* **Triple Session admin access** — required to connect a CRM integration under **Settings** > **CRM**.

## What the integration does

Triple Session AI Coach uses a **HubSpot Private App** to securely interact with your CRM. Once connected, the integration can:

* **Fetch deals** — retrieve details about open deals to provide relevant context during call evaluations.
* **Map deal objects to AI Coach Deal Insights** — connect your HubSpot Deal object to an AI Coach Deal Insight.
* **Update deals** — automatically push evaluation data to HubSpot to keep your CRM up to date.
* **Access contact and company data** — use HubSpot CRM objects to enrich call context with account and contact information.
* **Work with tickets** — [add meeting notes to open tickets and update ticket properties through Automations](https://docs.triplesession.com/automations/hubspot-tickets.md).

## Connect HubSpot with a Private App

**1. Navigate to Legacy Apps in HubSpot**

In HubSpot, open **Settings**. In the left sidebar, expand **Integrations** and click **Legacy Apps**.

![HubSpot Settings — navigate to Legacy Apps](https://mintcdn.com/triplesession/yFAMl9nxmwZNf4Xx/images/integrations/hubspot/crm-1.png?fit=max\&auto=format\&n=yFAMl9nxmwZNf4Xx\&q=85\&s=ad875da78e758f65b7a5d63a15e4145d)

**2. Create a new private app**

Click **Create** to start creating a new legacy app. When asked what kind of legacy app to create, select **Private** — for one account.

![Create Legacy App dialog — select Private](https://mintcdn.com/triplesession/yFAMl9nxmwZNf4Xx/images/integrations/hubspot/crm-2.png?fit=max\&auto=format\&n=yFAMl9nxmwZNf4Xx\&q=85\&s=1bb75dfb9bbcd20023c78466df104037)

**3. Add the recommended scopes**

In the app configuration, go to the **Scopes** section. Add the following scopes exactly as listed. The `tickets` scope enables [HubSpot ticket automations](https://docs.triplesession.com/automations/hubspot-tickets.md).

```text theme={null}
crm.objects.companies.read
crm.objects.companies.write
crm.objects.contacts.read
crm.objects.contacts.write
crm.objects.deals.read
crm.objects.deals.sensitive.read
crm.objects.deals.write
crm.objects.owners.read
crm.schemas.companies.read
crm.schemas.contacts.read
crm.schemas.deals.read
sales-email-read
tickets
```

![HubSpot Scopes — recommended scopes selected](https://mintcdn.com/triplesession/k_wt4zNnrqjzzbhW/images/integrations/hubspot/crm-3.png?fit=max\&auto=format\&n=k_wt4zNnrqjzzbhW\&q=85\&s=9dbf0745ac06bed6a0b6d2a9216fd907)

**4. Create the app and copy your access token**

Complete the app setup. Once the app is created, HubSpot will display your access token. Copy the token — you'll need it in the next step.

![HubSpot private app created — copy access token](https://mintcdn.com/triplesession/yFAMl9nxmwZNf4Xx/images/integrations/hubspot/crm-4.png?fit=max\&auto=format\&n=yFAMl9nxmwZNf4Xx\&q=85\&s=45d7a628bd17d8375e75f3be4249553e)

**5. Go to CRM settings in Triple Session**

In Triple Session, open **Settings** from the sidebar and select **CRM**. Below the **Connect HubSpot** button, click **Use Private App (Legacy) instead**.

![Triple Session Settings — CRM page](https://mintcdn.com/triplesession/yFAMl9nxmwZNf4Xx/images/integrations/hubspot/crm-5.png?fit=max\&auto=format\&n=yFAMl9nxmwZNf4Xx\&q=85\&s=0567ff06222396767509cbd3cbbb9719)

**6. Paste your access token and connect**

In the **Connect with a Private App** dialog, paste the access token from HubSpot into the **HubSpot Access Token** field, then click **Connect to HubSpot**.

![Triple Session CRM — paste token and connect](https://mintcdn.com/triplesession/yFAMl9nxmwZNf4Xx/images/integrations/hubspot/crm-6.png?fit=max\&auto=format\&n=yFAMl9nxmwZNf4Xx\&q=85\&s=7addf36818aa431b47ba6b463612296a)

***

After connecting, see [Keep Your CRM Updated](https://docs.triplesession.com/crm/keep-crm-updated.md) to learn how to push insights manually or automatically, and [Map Fields](https://docs.triplesession.com/crm/map-fields.md) to configure which deal properties get updated.

***

## How to find your access token for an existing app

If you already created a HubSpot private app for Triple Session and need to retrieve the token:

**1. Go to HubSpot Settings → Legacy Apps**

In HubSpot, open **Settings** → **Integrations** → **Legacy Apps**.

![HubSpot Settings — navigate to Legacy Apps](https://mintcdn.com/triplesession/yFAMl9nxmwZNf4Xx/images/integrations/hubspot/crm-7.png?fit=max\&auto=format\&n=yFAMl9nxmwZNf4Xx\&q=85\&s=aaa42ae62056f24c30826e76eeec73fe)

**2. Find the Triple Session app**

In the **Development** section, navigate to **Legacy Apps**. Click on your **Triple-Session-AICoach** private app.

![HubSpot Legacy Apps list — select Triple Session app](https://mintcdn.com/triplesession/yFAMl9nxmwZNf4Xx/images/integrations/hubspot/crm-8.png?fit=max\&auto=format\&n=yFAMl9nxmwZNf4Xx\&q=85\&s=f9edfeb5c48c50f9256f60df492e280e)

**3. Verify scopes and copy the token**

Confirm all recommended scopes, including `tickets`, are present in the **Scopes** section. Then navigate to the **Auth** tab to copy your access token.

![HubSpot private app scopes](https://mintcdn.com/triplesession/k_wt4zNnrqjzzbhW/images/integrations/hubspot/crm-9.png?fit=max\&auto=format\&n=k_wt4zNnrqjzzbhW\&q=85\&s=ce73326a8f916c6d9b1490ab06363234)

***

## Support

* **Missing scopes:** If the connection fails or ticket automations are unavailable, double-check that all thirteen recommended scopes listed above are added to the private app.
* **Need help?** Contact the Triple Session support team at **[support@triplesession.com](mailto:support@triplesession.com)**.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.