# Integrating with HubSpot

You can connect your HubSpot account to Drivetrain in a few quick steps. This guide walks you through how to do it.

### Prerequisites

To complete this integration, make sure you have:

* An active **HubSpot** **account** with **API permissions**
* **Admin access** in Drivetrain

{% hint style="info" %}
**Recommended**: Connect using your **HubSpot Super Admin account** to avoid permission issues with specific objects.
{% endhint %}

### Step 1: Add a Data Source in Drivetrain

1. Log in to Drivetrain and go to the **Data page**
2. Click the **+ icon** to **add a new data source**
3. Select **HubSpot** from the list of available integrations
4. Click **Login to connect**

<figure><img src="/files/0U33XFp6iZ3Crfx3Hyq9" alt=""><figcaption></figcaption></figure>

### Step 2: Log in to HubSpot

You’ll be redirected to the **HubSpot authorization** **screen**.

1. Enter your **HubSpot login credentials**
2. When prompted, select the correct **company account**
3. Click **Choose Account**
4. Review the **list of permissions** Drivetrain is requesting
5. Click **Connect app** to authorize the integration

{% hint style="info" %}
Drivetrain only **reads** your CRM data—no changes will be made.
{% endhint %}

<figure><img src="/files/zIezyoDPzGprDe7j5tBN" alt=""><figcaption></figcaption></figure>

### Step 3: Sync starts automatically

After authorization:

* You’ll be **redirected** back to Drivetrain
* The **HubSpot data source** will appear in the **Data** **page** **sidebar** with a **Syncing** indicator&#x20;
* Within a few minutes, datasets like **Deal**, **Company**, **Contact**, **Pipeline**, and others will begin to populate

<figure><img src="/files/5WvY0f5vMYLr4fJL9rV8" alt=""><figcaption></figcaption></figure>

### Next Steps

Once the sync is complete, you can:

* Use **HubSpot data** in your planning models and reports
* Access objects such as:
  * Contacts
  * Companies
  * Deals
  * Pipelines and stages
  * Users and associations

No manual data setup is required. You can begin using these datasets immediately across Drivetrain’s planning, reporting, and metrics workflows.

### Troubleshooting

If you run into an error while connecting:

* Retry the integration using an account with higher permissions, such as a **Super Admin**.
* Log out of HubSpot and reconnect from Drivetrain.
* Try the integration in an **incognito window** to rule out cookie or session issues.

If the issue persists, contact your **Drivetrain onboarding partner** for help.

{% hint style="info" %}
Include a **screenshot** or **brief description** of the error message. We'll help you troubleshoot and guide you through next steps.
{% endhint %}

### Need to Grant Temporary Access?

In **rare cases**—such as **data inconsistencies** or **bug investigations**—your Drivetrain team may request temporary access to your HubSpot account.

**View:** [Grant temporary access to HubSpot](/integration-guide/integrate-with-drivetrain/crm/integrating-with-hubspot/grant-temporary-access-to-hubspot.md)

This is not required for setup or general connection issues.


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://integrations.drivetrain.ai/integration-guide/integrate-with-drivetrain/crm/integrating-with-hubspot.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.