<!-- Source: https://docs.vinsi.ai/api-integration/gohighlevel -->
# GoHighLevel API Integration

Connect GoHighLevel to VINSI.AI using OAuth 2.0 and expose CRM functionality to AI Phone Agents via Custom API tools.

Created: January 26, 2026

## Overview

GoHighLevel provides a REST API that allows access to CRM data such as contacts, opportunities, conversations, and custom fields.

VINSI.AI integrates with GoHighLevel using OAuth 2.0, enabling secure, location-scoped access without exposing API keys to agents.

## Authentication

GoHighLevel authentication is handled via OAuth 2.0.

1. Navigate to **Settings → API Integration → GoHighLevel**
2. Click **Connect with GoHighLevel API**
3. Select the GoHighLevel location to authorize
4. Approve access to complete the connection

Access tokens are stored securely and refreshed automatically.

## GoHighLevel API

Once authenticated, GoHighLevel API endpoints can be accessed under:

`https://services.leadconnectorhq.com`

Example endpoints include:

- `/contacts/` — list and manage contacts
- `/opportunities/` — CRM pipeline data
- `/conversations/` — messages and threads

## Custom API Tool Configuration

Add New Tool

Go to **Tools → Add Tool** and configure:

- **Tool Type:** Custom API
- **Tool Name:** GoHighLevel – Get Contacts
- **Server URL:** `https://services.leadconnectorhq.com/contacts/`
- **Method:** GET
- **Headers:** OAuth Authorization (auto-injected)

## Example: Fetch Contacts

GoHighLevel Custom API Tool

Server URL:
https://services.leadconnectorhq.com/contacts/

Method:
GET

This tool can be invoked by AI agents during a call to retrieve CRM contact data in real time.

## Important Notes

- Access is scoped per GoHighLevel location.
- OAuth tokens are automatically refreshed.
- GoHighLevel enforces rate limits per account.
- Custom API tools should be narrowly scoped per use case.
