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

# HubSpot

> Learn how to connect HubSpot with Alguna

The Alguna Hubspot integration offers seamless synchronization of data between accounts in Hubspot and Alguna.

## Pre-requisites

You must have an active HubSpot account and admin rights to connect to Alguna.

We also recommend connecting your Hubspot account in your Sandbox before connecting to production.

## Overview

### Permissions

Alguna automatically sets up technical mechanisms in your HubSpot instance upon connection to enable notifications and benefit from real-time synchronization.

For this, we recommend using a user with a System Administrator profile when connecting your HubSpot instance. Otherwise, the user account used needs to have specific permissions.

## Set up HubSpot

Using the email address of the service account you created earlier, grant the following permissions:

<Note>**Production environment:** [https://app.alguna.io/settings/integrations](https://app.alguna.io/settings/integrations) </Note>
<Note>**Sandbox environment:** [https://app.sandbox.alguna.io/settings/integrations](https://app.sandbox.alguna.io/settings/integrations) </Note>

<Steps>
  <Step title="In Alguna, please navigate to the Integrations page">
    Once logged into the correct environment, go to General Settings → Integrations.
  </Step>

  <Step title="Click on the Connect button for the Hubspot integration">
    On the Integrations Page → Click Connect on Hubspot integration.
    A modal will pop-up asking you to allow access into your Hubspot instance.
  </Step>

  <Step title="Name integration for your future reference">
    Once connected, you may name the integration.
  </Step>

  <Step title="Choose syncing option ">
    On the next screen, choose to use Hubspot as a source of creating new accounts in Alguna (this setting only applies to Hubspot → Alguna).
  </Step>

  <Step title="Complete integration">
    On the next screen you can choose to connect all your existing customers. If you need help with a full migration, contact `support@alguna.io`.
  </Step>
</Steps>

## Syncing Flow

### Account Creation

The integration can import customers once they get to a configured deal stage (for example `closedwon` in HubSpot's default pipeline).

### Usage data and Hubspot ID

As soon as Hubspot account has been created, Alguna uses Hubspot ID as an external ID (alias) so any usage data sent to Alguna with that ID would automatically be assigned to the original account.

## Disconnect

Please send a request to [support@alguna.io](mailto:support@alguna.io) for any disconnections. This is to make sure that we can safely follow the disconnection process without any impact on your existing data.