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

# Connect HubSpot

> Bring your HubSpot deals and companies into Sapt with a read-only key. It takes about two minutes.

Sapt reads your HubSpot deals and companies into your [CRM](/docs/mintlify/platform/crm), so your whole pipeline lives in one place. Sapt only reads: it never changes anything in HubSpot and never messages anyone from what it brings in.

You need admin access (Developer Tools) in the HubSpot account. Each HubSpot account gets its own key. If you run two, make a key in each and connect both on the same HubSpot card in Sapt.

<Steps>
  <Step title="Open Development in HubSpot">
    In HubSpot, open **Development** from the left menu. Newer HubSpot accounts replaced private apps with service keys, so click **Create a service key**.

    <Frame>
      <img src="https://mintcdn.com/sapt/l3__my0qJyfhePP9/docs/mintlify/images/integrations/hubspot/1-development-settings.png?fit=max&auto=format&n=l3__my0qJyfhePP9&q=85&s=7009bb8d5207733f05799c45f89a8514" alt="HubSpot Development settings with the Create a service key button outlined" width="1600" height="897" data-path="docs/mintlify/images/integrations/hubspot/1-development-settings.png" />
    </Frame>
  </Step>

  <Step title="Go to Service Keys">
    If you land on a different page, open **Keys**, then **Service Keys**, and click **Create service key**.

    <Frame>
      <img src="https://mintcdn.com/sapt/l3__my0qJyfhePP9/docs/mintlify/images/integrations/hubspot/2-service-keys.png?fit=max&auto=format&n=l3__my0qJyfhePP9&q=85&s=ebfdc06683c69d383df16d512debfe81" alt="The Service Keys page with Service Keys and Create service key outlined" width="1600" height="1063" data-path="docs/mintlify/images/integrations/hubspot/2-service-keys.png" />
    </Frame>
  </Step>

  <Step title="Name the key and add read access">
    Name the key **Sapt**. Click **Add new scope** and add these four, all read-only:

    * `crm.objects.deals.read`
    * `crm.objects.companies.read`
    * `crm.objects.contacts.read`
    * `crm.schemas.deals.read` (your pipeline and stage names)

    Then click **Create**.

    <Frame>
      <img src="https://mintcdn.com/sapt/l3__my0qJyfhePP9/docs/mintlify/images/integrations/hubspot/3-name-and-scopes.png?fit=max&auto=format&n=l3__my0qJyfhePP9&q=85&s=05027f10da32c09d3b68a486927187b8" alt="The Create Service Key form with the name, Add new scope and Create outlined" width="1600" height="1008" data-path="docs/mintlify/images/integrations/hubspot/3-name-and-scopes.png" />
    </Frame>
  </Step>

  <Step title="Copy the key">
    On the key's page, click **Copy**. Keep it private, like a password.

    <Frame>
      <img src="https://mintcdn.com/sapt/l3__my0qJyfhePP9/docs/mintlify/images/integrations/hubspot/4-copy-key.png?fit=max&auto=format&n=l3__my0qJyfhePP9&q=85&s=f6c081026617c0f2c704fb669cb954cf" alt="The new Sapt service key with Copy outlined" width="1467" height="794" data-path="docs/mintlify/images/integrations/hubspot/4-copy-key.png" />
    </Frame>
  </Step>

  <Step title="Paste it into Sapt">
    In Sapt, open **Integrations** and choose **HubSpot**. Paste the key into **Service key or private app access token** and click **Connect**. Sapt checks the key with HubSpot before saving it, so a mistyped key is caught on the spot.
  </Step>
</Steps>

## What happens next

* On the first connect, Sapt brings in all of your deals and companies, each deal with its stage, amount and close date.
* After that, Sapt checks HubSpot for changes every hour.
* Bringing them in again never creates duplicates.

<Note>
  On an older HubSpot account you may see **Private Apps** instead of service keys. Go to **Settings**, **Integrations**, **Private Apps**, create an app with the same four read scopes, copy its access token, and paste it into Sapt the same way.
</Note>

## Turning it off

You can add or remove the key's scopes later from its page in HubSpot. Delete or rotate the key there and Sapt stops reading straight away. You can also disconnect HubSpot from **Integrations** in Sapt.


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