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

# HubSpot

> Connect HubSpot to AccessOwl over the API to sync users, seats, permission sets and teams, and to provision and deprovision access.

AccessOwl integrates with HubSpot over the HubSpot API to provision and deprovision user access in your HubSpot account, and to keep your list of HubSpot users and their permissions in sync.

<Info>
  The HubSpot API integration is in beta.
</Info>

## Capabilities

<CardGroup cols={2}>
  <Card title="Structure Sync" icon="diagram-project">
    AccessOwl periodically syncs the seats, permission sets and teams of your HubSpot account.
  </Card>

  <Card title="User Sync" icon="arrows-rotate">
    AccessOwl periodically syncs a list of users along with their assigned seats, permission sets and teams.
  </Card>

  <Card title="Provisioning" icon="user-plus">
    AccessOwl creates user accounts with the requested seat, permission set and teams during access requests.
  </Card>

  <Card title="Deprovisioning" icon="user-minus">
    AccessOwl removes the user's access in HubSpot during access revocations.
  </Card>
</CardGroup>

## Prerequisites

* **Super Admin** access in HubSpot, so you can connect AccessOwl, approve the user management permissions it requests and turn on the optional permission for paid seats.

## Setup

<Steps>
  <Step title="Add HubSpot in AccessOwl">
    Either add a new application or open Applications and click the +-symbol, then select HubSpot.
  </Step>

  <Step title="Connect your HubSpot account">
    In the integration assistant, click **Connect**. You are redirected to HubSpot.

    * Sign in to HubSpot with your Super Admin account.
    * Select the HubSpot account you want to connect.
    * Review the required permissions AccessOwl requests.
    * Under **Optional**, tick the box next to "Make changes to your account's billing settings" so AccessOwl can assign and remove paid seats.
    * Click **Connect app**.

          <img src="https://mintcdn.com/accessowl/sFzMzQlwqQx59Ciu/images/hubspot-connect-optional-billing-permission.png?fit=max&auto=format&n=sFzMzQlwqQx59Ciu&q=85&s=fd6416a0b68c8f3b36646620c3d63467" alt="HubSpot connection screen with the optional billing settings permission and its checkbox under Optional" width="2000" height="1155" data-path="images/hubspot-connect-optional-billing-permission.png" />

    <Note>
      During the beta, HubSpot shows a notice that the AccessOwl app is not verified yet. This is expected, and you can continue with the connection.
    </Note>
  </Step>

  <Step title="Back in AccessOwl">
    HubSpot redirects you back to AccessOwl, and HubSpot is connected.
  </Step>
</Steps>

## Turn on the paid seats permission

AccessOwl needs HubSpot's optional billing permission to assign and remove paid seats, such as Sales Enterprise seats. HubSpot leaves it unticked by default, so if you didn't tick it when connecting, a Super Admin can turn it on in HubSpot at any time.

* In HubSpot, click the **settings icon** in the top navigation bar.
* In the left sidebar, go to **Integrations** > **Connected Apps** and click AccessOwl.
* Click **Actions** and select **Go to settings**.
* Under **Optional permissions**, turn on **Manage and view your account settings**. Its description reads "Make changes to your account's billing settings. This includes managing and assigning paid seats for users."

<img src="https://mintcdn.com/accessowl/sFzMzQlwqQx59Ciu/images/hubspot-connected-app-optional-permissions.png?fit=max&auto=format&n=sFzMzQlwqQx59Ciu&q=85&s=41653236ffe4bc0d1304007e6a0ab18d" alt="AccessOwl in HubSpot Connected Apps with Manage and view your account settings listed under Optional permissions" width="2000" height="1032" data-path="images/hubspot-connected-app-optional-permissions.png" />

<Note>
  Without this permission, AccessOwl still syncs HubSpot and provisions users, permission sets and teams, but provisioning and deprovisioning that involve a paid seat are reassigned to the [Application Admin](/guides/applications/admins-owners).
</Note>

## Disconnect HubSpot

You can remove AccessOwl's access to your HubSpot account at any time in HubSpot.

* In HubSpot, click the **settings icon** in the top navigation bar.
* In the left sidebar, go to **Integrations** > **Connected Apps**.
* Click **Actions** next to AccessOwl and select **Uninstall**.
* Type `uninstall` in the dialog box and click **Uninstall**.

Once uninstalled, AccessOwl can no longer sync data or provision and deprovision users in HubSpot.

## Troubleshooting

<AccordionGroup>
  <Accordion title="Permission sets in HubSpot can be restricted by seat type">
    Some HubSpot permission sets are only available with certain seat types. When requesting access in AccessOwl, make sure the permission set and seat you select are a valid combination for your HubSpot setup.
  </Accordion>

  <Accordion title="Teams do not show up in AccessOwl">
    Teams are only available on some HubSpot subscriptions. If your subscription does not include teams, AccessOwl syncs and provisions seats and permission sets only.
  </Accordion>

  <Accordion title="&#x22;Request for Integration Permissions&#x22; error during setup">
    HubSpot shows this error when the user connecting AccessOwl does not have enough permissions. Connect AccessOwl with a Super Admin account.
  </Accordion>

  <Accordion title="Paid seat provisioning and deprovisioning are reassigned to the Application Admin">
    AccessOwl needs HubSpot's optional **Manage and view your account settings** permission to assign and remove paid seats. HubSpot leaves this permission unticked when you connect AccessOwl, so unless it was ticked, provisioning and deprovisioning that involve a paid seat are reassigned to the [Application Admin](/guides/applications/admins-owners) until a Super Admin turns it on. See [Turn on the paid seats permission](#turn-on-the-paid-seats-permission).
  </Accordion>
</AccordionGroup>


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