Skip to main content
The LeadConnector integration (GoHighLevel) lets your agents and workflows manage contacts, conversations, tasks, notes, tags, campaigns, and workflows inside your GHL sub-account. Auth type: OAuth
For how integrations work overall (permissions, authentication, troubleshooting), see the main guide: App Integrations.

Connect LeadConnector

  1. Go to Settings → Apps in Hyper
  2. Select LeadConnector → Connect New
  3. Authorize with GoHighLevel and select the sub-account(s) Hyper should manage
You can connect multiple GHL sub-accounts and pick which one a given agent or flow uses.

Common capabilities

  • Contacts — search, get, create, update, upsert, delete
  • Tasks — list, create, update, delete
  • Notes — list, create, update, delete
  • Tags — add, remove
  • Campaigns — add to / remove from a campaign
  • Workflows — add to a workflow
  • Conversations — search, get, create, update; list and send messages within a conversation

Use in Chat

  1. In a chat, open the tool selector and enable LeadConnector
  2. Ask your agent to update your CRM
Example prompt:

Use in Agents

In Agents → Settings, add LeadConnector to an SDR / sales-ops agent. Common pattern: agent reads inbox → routes new leads → creates contacts in GHL → starts workflow.

Use in Flows

Add LeadConnector nodes to lead-capture pipelines: form → enrich → create contact → tag → add to workflow → notify rep.

Troubleshooting

  • 404 on contact: confirm the contact ID belongs to the sub-account you authorized
  • Workflow won’t trigger: workflows need to be active (not draft) before contacts can be added to them
  • Auth expired: GHL tokens expire — disconnect and reconnect to refresh

Available Actions

Hyper agents can run the following actions for this integration. Each action can be individually set to Enabled, Requires Approval, or Disabled in your agent’s toolkit settings. Actions can be set to one of three control states: Configure these in the agent’s toolkit settings or in workspace defaults.