# HubSpot CRM

Sync contacts between Starlight and HubSpot.

Connect HubSpot to import existing contacts into Starlight or export your Starlight leads to HubSpot.

## Setup

#### 1. Go to Connectors

Click **Connectors** in the sidebar

#### 2. Click Connect HubSpot

Under the CRM section, click **Connect** next to HubSpot

#### 3. Authorize with HubSpot

Sign in to your HubSpot account and grant Starlight permission to read and write contacts

## Importing from HubSpot

Import your existing HubSpot contacts into Starlight:

1. Go to **Connectors** and find your HubSpot connection

2. Click **Import Contacts**

3. Starlight fetches all contacts from your HubSpot portal

4. Contacts are deduplicated by email — existing leads won't be duplicated

Imported contacts appear in your Contacts page with status "New".

## Exporting to HubSpot

Export Starlight leads to your HubSpot CRM:

1. Select contacts from the Contacts page

2. Click **Export to HubSpot**

3. New contacts are created in HubSpot; existing ones (matched by HubSpot contact ID) are updated

## Field Mapping

| Starlight Field | HubSpot Field |
| --- | --- |
| First name | `firstname` |
| Last name | `lastname` |
| Email | `email` |
| Phone | `phone` |
| Company | `company` |
| Title | `jobtitle` |

## Deduplication

Starlight tracks which leads are linked to HubSpot contacts via an internal ID. On re-import or re-export:

- Contacts already linked are **updated**, not duplicated
- New contacts are **created** in the target system
- Matching is done by the stored HubSpot contact ID first, then by email

## Disconnecting

Go to **Connectors** and click **Disconnect** next to HubSpot. Your existing contact data in Starlight is preserved, but future syncs won't work until you reconnect.