# HighLevel

To integrate HighLevel and Perkville, you'll either need a location API key, a private integration token, or both. The difference in credentials is dependent on which HighLevel API version we need to use.

{% hint style="info" %}
For calendar event syncs, we'll need V2 access.
{% endhint %}

Please provide your keys in a secure manner to your Perkville representative or enter it directly into [Middle](https://middle.app), our integration platform.

{% embed url="<https://marketplace.gohighlevel.com/docs/Authorization/PrivateIntegrationsToken/index.html#whats-the-difference-between-private-integrations-and-api-keys>" %}

## Location API key - V1

{% stepper %}
{% step %}

### Get your HighLevel location API key

You can get your [location API key](https://help.gohighlevel.com/support/solutions/articles/48001060529-highlevel-api#1.%C2%A0Location-Level-%3E-Settings%C2%A0%3E-Business-Info) from the sub-account you are connecting:

1. Go to **Settings**
2. Go to **Business Info**
3. Go to API Key

{% embed url="<https://help.gohighlevel.com/support/solutions/articles/48001060529-highlevel-api#1.%C2%A0Location-Level-%3E-Settings%C2%A0%3E-Business-Info>" %}

<figure><img src="/files/vj8NqM5DbgjPRQZUKOul" alt=""><figcaption></figcaption></figure>
{% endstep %}

{% step %}

### Provide the API key to Perkville

Either send the API key to your Perkville representative via a secure method, like OneTimeSecret, or work with your rep. to gain access to your Middle account to enter the key yourself.

{% embed url="<https://onetimesecret.com/>" %}
{% endstep %}
{% endstepper %}

## Private integration token - V2

{% stepper %}
{% step %}

### Create a private integration token

1. Navigate to your HighLevel dashboard
2. Switch to the sub-account you want to connect
3. Click on **Settings** at the bottom of the left-hand toolbar
4. Click on **Private Integrations** on the left-hand toolbar
5. You'll want to set `View Calendar Events` as a scope

{% embed url="<https://marketplace.gohighlevel.com/docs/Authorization/PrivateIntegrationsToken/index.html#how-do-i-manage-private-integrations>" %}
{% endstep %}

{% step %}

### Provide the API key to Perkville

Either send the API key to your Perkville representative via a secure method, like OneTimeSecret, or work with your rep. to gain access to your Middle account to enter the key yourself.

{% embed url="<https://onetimesecret.com/>" %}
{% endstep %}
{% endstepper %}


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.perkville.com/overview/integrations/integration-reference/highlevel.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.