How to Create a GHL Private Integration Token (PIT)

Last updated: February 21, 2026

What is a Private Integration Token?

A Private Integration Token (PIT) is how Orbit Velocity connects to your GoHighLevel account. It gives us read-only access to your contacts, conversations, and pipeline data so the AI can draft follow-ups based on real conversation history.

Your PIT stays encrypted and is never shared. You can revoke it at any time from your GHL settings.


Step-by-Step: Create Your PIT

1. Log into GoHighLevel

Go to app.gohighlevel.com and sign in to the sub-account (location) you want to connect.

Important: Make sure you're in the correct sub-account, not the agency view. The PIT is scoped to whichever sub-account you're in when you create it.

2. Open Settings

Click the gear icon in the bottom-left corner of the sidebar, or navigate to Settings.

3. Go to "Integrations"

In the Settings menu, find and click Integrations in the left sidebar.

4. Click "Private Integrations"

At the top of the Integrations page, you'll see tabs. Click Private Integrations.

5. Create a New Integration

Click the "Create Private Integration" button.

Fill in the details:
- Name: Orbit Velocity (or any name you'll recognize)
- Description: Optional — e.g., "AI follow-up assistant"

6. Set Permissions

Grant the following permissions (read access is sufficient):

Permission Access Level
Contacts Read
Conversations Read
Opportunities Read
Users Read

You can grant additional permissions if needed later. Orbit Velocity only requires read access to function.

7. Copy Your Token

After creating the integration, GHL will display your Private Integration Token. It looks like a long string starting with pit-....

Copy this token immediately — GHL may not show it again.

8. Paste into Orbit Velocity

Go to your Orbit Velocity onboarding wizard (or Settings > Integrations) and paste the token into the GHL API Key field.

Click Save — Orbit Velocity will verify the connection and begin syncing your data.


Troubleshooting

"Invalid API Key" error

Data not syncing

Need to rotate your token?

  1. Go to GHL Settings > Integrations > Private Integrations
  2. Find the Orbit Velocity integration
  3. Click Regenerate Token
  4. Copy the new token and update it in Orbit Velocity Settings > Integrations

Questions?

Reach out to support@orbitvelocity.com — we're happy to help you get connected.