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

# Connect HubSpot to Retell AI with a Private App

> Create a HubSpot Private App and generate an access token to connect HubSpot to Retell AI for contact sync and call activity logging.

This guide walks you through creating a HubSpot Private App and obtaining the access token needed to connect HubSpot to Retell AI for CRM integration.

<Note>
  This is the setup guide for connecting HubSpot as a CRM data source. If you're looking for the HubSpot Marketplace app that triggers outbound calls from HubSpot workflows, see the [HubSpot Marketplace App](/integrations/hubspot-marketplace) guide.
</Note>

## Prerequisites

* A HubSpot account with **Super Admin** permissions
* A HubSpot plan that supports Private Apps (Professional or Enterprise)

## Step 1: Create a Private App

<Steps>
  <Step title="Navigate to Private Apps">
    In your HubSpot account, click **Development** in the left sidebar, then go to **Private Apps**.
  </Step>

  <Step title="Create a new Private App">
    Click **Create a private app**.

    Fill in the **Basic Info** tab:

    * **Name**: Enter a descriptive name (e.g., `Retell AI Integration`)
    * **Description** (optional): A brief note about the purpose (e.g., "Syncs contacts and logs call activity for Retell AI")

    <Frame>
      <img src="https://mintcdn.com/retellai/M9dkUq1iShh05WLW/images/integration/hubspot-new-app.png?fit=max&auto=format&n=M9dkUq1iShh05WLW&q=85&s=340314861d186ce1cdbeb9151bcea4b7" alt="Create Private App basic info form" width="3456" height="1828" data-path="images/integration/hubspot-new-app.png" />
    </Frame>
  </Step>
</Steps>

## Step 2: Configure Scopes

<Steps>
  <Step title="Open the Scopes tab">
    Navigate to the **Scopes** tab during the Private App creation flow.
  </Step>

  <Step title="Select the required scopes">
    Search for and enable the following scopes:

    **Required scopes:**

    | Scope                  | Access       | Purpose                                              |
    | ---------------------- | ------------ | ---------------------------------------------------- |
    | `crm.objects.contacts` | Read & Write | Read and update contact records                      |
    | `crm.schemas.contacts` | Read         | Fetch contact property definitions for field mapping |
  </Step>
</Steps>

## Step 3: Generate the Access Token

<Steps>
  <Step title="Create the Private App">
    Click **Create app** in the top-right corner.

    Review the scopes in the confirmation dialog and click **Continue creating**.
  </Step>

  <Step title="Copy the access token">
    After the app is created, you'll see the **Access token** displayed. Click **Show token** and then copy it.

    <Warning>
      This is the only time the full token is displayed. Copy it now and store it securely. If you lose it, you can rotate the token later, but the old token will be immediately invalidated.
    </Warning>
  </Step>
</Steps>

## Step 4: Connect HubSpot in Retell

<Steps>
  <Step title="Navigate to Integrations">
    In the Retell Dashboard, go to the **Integrations** section and select **HubSpot**.
  </Step>

  <Step title="Enter the access token">
    Paste the **Private App access token** from Step 3.

    <Frame>
      <img src="https://mintcdn.com/retellai/M9dkUq1iShh05WLW/images/integration/hubspot-config-integration.png?fit=max&auto=format&n=M9dkUq1iShh05WLW&q=85&s=6250b19fd8ade95e11418b97c31c90f1" alt="Entering HubSpot access token in Retell" width="2878" height="1042" data-path="images/integration/hubspot-config-integration.png" />
    </Frame>
  </Step>
</Steps>

## Managing Your Private App

### Rotating the access token

If you need to rotate the token:

1. Go to **Development > Legacy Apps** in HubSpot
2. Select your Retell AI Private App
3. Click the **Auth** tab
4. Click **Rotate token**
5. Update the token in the Retell Dashboard

<Warning>
  Rotating the token immediately invalidates the old token. Update the token in Retell promptly to avoid sync interruptions.
</Warning>

### Modifying scopes

To add or remove scopes:

1. Go to **Development > Legacy Apps** in HubSpot
2. Select your Retell AI Private App
3. Click the **Scopes** tab
4. Update scopes as needed and save