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

# GoHighLevel Integration

> How to connect VozAgent to GoHighLevel for contact sync, calendar booking, tag management, and pipeline tracking.

The GoHighLevel (GHL) integration connects your VozAgent account to your GHL location so contacts, appointments, and tags stay in sync. Your AI assistant can book directly to your GHL calendar, push new contacts from calls, and track leads through your pipelines.

***

## What the GoHighLevel Integration Does

The integration provides three main capabilities:

### Contact Sync

* **Bidirectional contact sync** -- contacts flow between VozAgent and GoHighLevel in both directions
* **Automatic sync on new contacts** -- new contacts from calls can be pushed to GHL automatically
* **Manual refresh available** -- trigger a sync at any time with the Sync Contacts button
* **VozAgent tag added to synced contacts** -- all contacts synced from VozAgent are tagged with a "vozagent" tag in GHL for easy identification

### Calendar Booking

* **Book to GHL calendar** -- your AI assistant can schedule appointments directly on your GoHighLevel calendar during calls
* **Real-time availability check** -- the assistant checks your calendar availability before offering time slots
* **Automatic confirmations** -- callers receive confirmation when an appointment is booked
* **Works during AI calls** -- booking happens live while the assistant is on the phone with the caller

### Tag Sync

* **Bidirectional tag sync** -- tags are kept in sync between VozAgent and GHL
* **Tags added in VozAgent push to GHL** -- when you tag a contact in VozAgent, the tag appears in GHL
* **Tags deleted in GHL sync back** -- removing a tag in GHL is reflected in VozAgent
* **"vozagent" tag auto-added** -- a "vozagent" tag is automatically applied to all synced contacts

***

## How to Connect

Connecting GoHighLevel requires a Private Integration Token and Location ID from your GHL account. The setup uses a step-by-step wizard with four stages.

### Step 1: Get Your API Credentials

Before starting the connection in VozAgent, you need two pieces of information from GoHighLevel:

1. **Private Integration Token** -- In GHL, go to **Settings > Business Profile > API Keys** (or visit `https://app.gohighlevel.com/settings/api-keys`). Copy your Private Integration Token -- it starts with `pit_`.

2. **Location ID** -- Find your Location ID in the GHL Settings under **Business Profile**, or look at the URL when you're inside a GHL location.

### Step 2: Start the Connection in VozAgent

1. Go to **Integrations** in your sidebar
2. Click the **GoHighLevel** card on the Third Parties tab
3. Click the **Connect GoHighLevel** button
4. A connection dialog will open with a progress bar showing four steps

### Step 3: Enter and Test Credentials

In the first step of the dialog:

1. Enter your **Private Integration Token** in the field (placeholder shows `pit_xxxxxxxxxxxxxxxx`)
2. Enter your **Location ID**
3. Click **Test Connection** to verify the credentials

If successful, your GHL location name and address will appear in a green confirmation. Click **Next** to continue.

### Step 4: Configure Calendar (Optional)

On the Calendar Setup step:

1. A dropdown lists all calendars from your GHL location
2. Select a calendar if you want your AI assistant to book appointments to it
3. Or choose **Skip - No calendar** if you don't need calendar booking
4. Click **Next**

### Step 5: Configure Pipeline (Optional)

On the Pipeline Setup step:

1. A dropdown lists all pipelines from your GHL location
2. Select a pipeline if you want new leads tracked as opportunities
3. If you select a pipeline, a second dropdown appears to choose the **default stage** for new opportunities
4. Or choose **Skip - No pipeline** to skip pipeline tracking
5. Click **Next**

### Step 6: Review and Connect

The summary step shows everything you've configured:

* **Location** -- your GHL location name
* **Calendar** -- the selected calendar (if any)
* **Pipeline** -- the selected pipeline and stage (if any)
* **Auto-sync contacts** toggle -- enabled by default, automatically pushes new contacts from calls to GHL

Review the settings and click **Connect** to save.

***

## Connection Status

Once connected, the integration page shows:

* A green **Connected** badge
* A status banner with your **GHL location name**
* The **last sync timestamp**
* Three action buttons: **Sync Contacts**, **Update Settings**, and **Disconnect**

***

## Sync Settings

When connected, the Sync Settings section displays your current configuration:

| Setting                | Description                                                                                           |
| ---------------------- | ----------------------------------------------------------------------------------------------------- |
| **Auto-sync Contacts** | Shows Enabled or Disabled -- controls whether new contacts from calls are automatically pushed to GHL |
| **Calendar**           | Shows the name of the GHL calendar used for appointment booking (if configured)                       |

To change these settings, click **Update Settings** to reopen the connection dialog.

***

## Syncing Contacts

Click **Sync Contacts** on the integration page to trigger a manual contact sync. A spinning animation appears while the sync is running. Use this when you want to ensure both systems are fully up to date.

***

## Disconnecting GoHighLevel

To disconnect:

1. Click the red **Disconnect** button on the integration page
2. A confirmation dialog will explain what happens: contact sync will stop and your assistants won't be able to book to your GHL calendar
3. Click **Disconnect** to confirm

Existing synced contacts will remain in both systems -- nothing is deleted.

***

## Troubleshooting

**"Test Connection" fails** -- Double-check that your Private Integration Token and Location ID are correct. Make sure the token has the required permissions in GHL. Tokens that start with `pit_` are Private Integration Tokens -- do not confuse them with OAuth tokens.

**No calendars found** -- Your GHL token may not have the `calendars.readonly` permission scope. Check your Private Integration Token permissions in GoHighLevel Settings.

**No pipelines found** -- Your GHL token may not have the `opportunities.readonly` permission scope. This is optional and won't prevent the connection from working.

**Contacts not syncing** -- Make sure **Auto-sync Contacts** is enabled. You can also use the **Sync Contacts** button to force a manual sync.

**Calendar booking not working** -- Verify that a calendar was selected during setup. Click **Update Settings** to check or change the calendar selection.

***

## Related Articles

* [Integrations Overview](/help/integrations/integrations-overview)
* [HubSpot Integration](/help/integrations/hubspot-integration)
* [Managing Contacts](/help/contacts-and-campaigns/managing-contacts)
* [Contact Tags and Filtering](/help/contacts-and-campaigns/contact-tags-and-filtering)