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

# GoHighLevel integration

> Integrate Nedzo with GoHighLevel to trigger AI voice calls from GHL workflows. Sync contacts, map custom fields, and automate outbound calls.

Connect GoHighLevel (GHL) to trigger AI voice calls directly from your GHL workflows using the "Make Nedzo Call" action.

## What it does

* **Workflow action** — Add a "Make Nedzo Call" step to any GHL workflow
* **Agent selection** — Pick which Nedzo agent handles the call from a dropdown
* **Contact sync** — GHL contact data is passed to Nedzo automatically
* **Two-way sync** — Contact updates in GHL are reflected in Nedzo

## How to connect

1. Go to **Settings > Integrations** in your dashboard
2. Find **GoHighLevel** and click **Connect**
3. Sign in with your GHL account
4. Select the GHL location to connect to your Nedzo workspace
5. You'll be redirected back once connected

Each GHL location maps to one Nedzo workspace.

## Using in GHL workflows

Once connected, a new action becomes available in your GHL workflow builder:

### 1. Add the action

1. Open any workflow in GHL
2. Add a new action step
3. Select **Make Nedzo Call**

### 2. Configure the action

| Field         | Required | Description                               |
| ------------- | -------- | ----------------------------------------- |
| Agent         | Yes      | Select which Nedzo agent handles the call |
| Phone Number  | Yes      | Contact's phone number (E.164 format)     |
| First Name    | No       | Contact's first name                      |
| Last Name     | No       | Contact's last name                       |
| Email         | No       | Contact's email address                   |
| Business Name | No       | Contact's company name                    |

The **Agent** dropdown automatically loads your Nedzo agents for the connected workspace.

### 3. Map contact fields

Use GHL's built-in contact variables to map fields:

```
Phone Number: {{contact.phone}}
First Name:   {{contact.firstName}}
Last Name:    {{contact.lastName}}
Email:        {{contact.email}}
Business:     {{contact.companyName}}
```

## Contact sync

When a call is triggered from GHL:

* If the contact doesn't exist in Nedzo, it's created automatically
* If the contact already exists (matched by phone or email), it's updated with the latest GHL data
* Custom fields from GHL are synced to Nedzo contact fields

## Authentication

The integration uses OAuth — no API keys needed. The GHL `locationId` identifies which workspace to use for each call.

## Error handling

| Error                  | Cause                                          | Fix                                                  |
| ---------------------- | ---------------------------------------------- | ---------------------------------------------------- |
| Location not connected | GHL location isn't linked to a Nedzo workspace | Reconnect from the Nedzo dashboard                   |
| Agent not found        | Selected agent was deleted                     | Update the workflow action to pick a different agent |
| Invalid phone number   | Phone isn't in E.164 format                    | Ensure GHL stores phones as `+14155551234`           |

## Disconnecting

1. Go to **Settings > Integrations**
2. Click **Disconnect** on the GoHighLevel card

This stops all GHL workflow actions from triggering Nedzo calls for that location.