# 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="https://2181708597-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FSiE75SeColbiBVbet0NZ%2Fuploads%2FAwSG6wFMzNsFEiHGRbK8%2Fv7ImipA4nl8A8guw8ytaSEMwo86JNVgvWA.gif?alt=media&#x26;token=99666f35-8650-444c-a9c6-5d2258685b26" 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 %}