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

# GoHighLevel setup

> Connect Intavia to GoHighLevel with the required scopes.

# GoHighLevel Integration Setup

## Required Scopes

Your GoHighLevel Private Integration token needs these **9 scopes**:

| Scope                       | Purpose                                   |
| --------------------------- | ----------------------------------------- |
| `contacts.readonly`         | Search and view contacts                  |
| `contacts.write`            | Create/update contacts and tags           |
| `calendars.readonly`        | View calendars and availability           |
| `calendars/events.readonly` | View appointments                         |
| `calendars/events.write`    | Book, reschedule, and cancel appointments |
| `opportunities.readonly`    | View pipelines and opportunities          |
| `opportunities.write`       | Create and update opportunities           |
| `locations.readonly`        | View location details                     |
| `locations/tags.readonly`   | View location tags                        |

***

## Setup Steps

### 1. Create Private Integration Token

1. Log in to **GoHighLevel**
2. Go to **Settings** → **Private Integrations**
   * Don't see it? Enable in **Settings** → **Labs** first
3. Click **Create new Integration**
   * Name: `Intavia AI Phone Agent`
4. Select the 9 scopes listed above
5. Click **Generate Token** → Copy it immediately (you can't see it again)

### 2. Connect in Intavia

1. Go to **Intavia** → **Integrations** → **GoHighLevel** → **Connect**
2. Paste your token
3. Select the location(s) you want to use
4. Click **Save**

***

## Troubleshooting

### "Invalid token" error

Token was copied incorrectly or has been deleted.

**Fix:** Generate a new token and copy the entire string with no extra spaces.

### "Authentication failed" on specific actions

Missing required scopes.

**Fix:** Create a new token with all 9 scopes listed above.

### Don't see "Private Integrations"

Feature not enabled.

**Fix:** Go to **Settings** → **Labs** → Enable "Private Integrations"

***

## References

* [GoHighLevel Private Integrations](https://help.gohighlevel.com/support/solutions/articles/155000003054)
* [API Scopes Reference](https://marketplace.gohighlevel.com/docs/Authorization/Scopes)

***

*Last Updated: January 2025*