Skip to main content
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.
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 guide.

​
Prerequisites

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

​
Step 1: Create a Private App

1

Navigate to Private Apps

In your HubSpot account, click Development in the left sidebar, then go to Private Apps.
2

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”)
Create Private App basic info form

​
Step 2: Configure Scopes

1

Open the Scopes tab

Navigate to the Scopes tab during the Private App creation flow.
2

Select the required scopes

Search for and enable the following scopes:Required scopes:
ScopeAccessPurpose
crm.objects.contactsRead & WriteRead and update contact records
crm.schemas.contactsReadFetch contact property definitions for field mapping

​
Step 3: Generate the Access Token

1

Create the Private App

Click Create app in the top-right corner.Review the scopes in the confirmation dialog and click Continue creating.
2

Copy the access token

After the app is created, you’ll see the Access token displayed. Click Show token and then copy it.
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.

​
Step 4: Connect HubSpot in Retell

1

Navigate to Integrations

In the Retell Dashboard, go to the Integrations section and select HubSpot.
2

Enter the access token

Paste the Private App access token from Step 3.
Entering HubSpot access token in Retell

​
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
Rotating the token immediately invalidates the old token. Update the token in Retell promptly to avoid sync interruptions.

​
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