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

# HubSpot

> Connect HubSpot for email intelligence, deal tracking, and contact management.

The HubSpot integration connects your CRM data to Superhawk AI, bringing email intelligence, deal tracking, and contact management into your trial workflows. See which emails were sent to trial contacts, track deal progression, and keep your CRM and Superhawk AI in sync without manual data entry.

## Prerequisites

* A HubSpot account with Super Admin or App Marketplace access permissions
* Workspace admin permissions in Superhawk AI

## Setup

<Steps>
  <Step title="Open integrations">
    Navigate to **Settings > Integrations** in your Superhawk AI workspace.
  </Step>

  <Step title="Find HubSpot">
    Locate HubSpot under the **CRM** category.
  </Step>

  <Step title="Start the connection">
    Click **Connect** on the HubSpot card.
  </Step>

  <Step title="Authorize Superhawk AI">
    You will be redirected to HubSpot. Review the requested permissions and click **Connect app** to authorize Superhawk AI.
  </Step>

  <Step title="Select data to sync">
    Choose which HubSpot objects to sync with Superhawk AI:

    * **Deals** -- sync deal stages, amounts, and close dates
    * **Contacts** -- sync contact details and associations
    * **Emails** -- pull in email activity linked to trial contacts
  </Step>

  <Step title="Map fields">
    Map your HubSpot fields to Superhawk AI fields. Superhawk AI provides default mappings for common fields, but you can customize them to match your team's HubSpot configuration.
  </Step>

  <Step title="Save">
    Click **Save** to activate the integration. The initial sync may take a few minutes depending on the volume of data in your HubSpot account.
  </Step>
</Steps>

## Configuration Options

After connecting HubSpot, you can adjust settings from **Settings > Integrations > HubSpot**.

* **Sync frequency** -- control how often Superhawk AI pulls updates from HubSpot (e.g., every 15 minutes, hourly, or daily).
* **Field mapping** -- update which HubSpot fields map to Superhawk AI fields at any time.
* **Two-way sync** -- enable bidirectional sync so changes made in Superhawk AI are pushed back to HubSpot.

<Tip>
  After connecting HubSpot, link your CRM accounts to trials in Superhawk AI for the best experience. See [managing accounts](/trials/managing-accounts) for details.
</Tip>

## Troubleshooting

<Warning>
  If the OAuth authorization fails, make sure your HubSpot user has Super Admin permissions or explicit App Marketplace access. Users with limited permissions may not be able to install third-party integrations.
</Warning>

<Tip>
  If specific fields are not syncing, check your field mappings. Custom HubSpot properties need to be explicitly mapped in Superhawk AI before their data will appear.
</Tip>