Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.hyperfx.ai/llms.txt

Use this file to discover all available pages before exploring further.

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:
For everyone who replied "yes" to my last email blast in LeadConnector, tag them with "qualified", add a follow-up task for me due tomorrow, and add them to the "Sales Sequence 1" workflow.

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