Affinity Design
Agencies

GoHighLevel Integration

Connecting GHL to manage contacts, appointments, and pipelines

Setup

  1. Create a Marketplace app at gohighlevel.com/marketplace
  2. Set the redirect URI to https://api.youragency.com/integrations/oauth/callback
  3. Configure env vars:
GHL_CLIENT_ID=your_client_id
GHL_CLIENT_SECRET=your_client_secret
GHL_REDIRECT_URI=https://api.youragency.com/integrations/oauth/callback

OAuth Flow

Clients authorize GHL access through the portal:

  1. Client clicks Connect GoHighLevel in the portal
  2. Redirected to GHL OAuth consent
  3. On approval, redirected back with auth code
  4. Platform exchanges code for access/refresh tokens
  5. Tokens stored securely in MongoDB

MCP Tools Available

With the ghl plugin enabled on an API key:

  • Contact lookup — Search by phone, email, or name
  • Appointments — Create, update, cancel
  • Opportunities — View and update pipeline stages
  • Notes — Add notes to contact records

With the ghl-social plugin:

  • Social planner — Schedule posts, view calendar
  • Analytics — Social performance metrics

On this page