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: OAuthDocumentation Index
Fetch the complete documentation index at: https://hyperfx.ai/docs/llms.txt
Use this file to discover all available pages before exploring further.
For how integrations work overall (permissions, authentication, troubleshooting), see the main guide: App Integrations.
Connect LeadConnector
- Go to Settings → Apps in Hyper
- Select LeadConnector → Connect New
- Authorize with GoHighLevel and select the sub-account(s) Hyper should manage
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
- In a chat, open the tool selector and enable LeadConnector
- Ask your agent to update your CRM
Use in Agents
InAgents → 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:| State | Behavior |
|---|---|
| Enabled | Agent runs the action automatically |
| Requires Approval | Agent pauses and waits for your confirmation before proceeding |
| Disabled | Action is blocked and cannot be used |
| Action | Description |
|---|---|
| Ghl Add Tags | Add tags to a contact in GoHighLevel |
| Ghl Add To Campaign | Add a contact to a campaign in GoHighLevel |
| Ghl Add To Workflow | Add a contact to a workflow in GoHighLevel |
| Ghl Block Slot | Block a time slot on a GoHighLevel calendar |
| Ghl Create Appointment | Create a new appointment in a GoHighLevel calendar |
| Ghl Create Blog Post | Create a new blog post in GoHighLevel |
| Ghl Create Business | Create a new business in GoHighLevel |
| Ghl Create Calendar | Create a new calendar in GoHighLevel with name, description, and slot settings |
| Ghl Create Contact | Create a new contact in GoHighLevel with name, email, phone, company, tags, and custom fields |
| Ghl Create Conversation | Create a new conversation for a contact in GoHighLevel |
| Ghl Create Custom Field | Create a new custom field in GoHighLevel |
| Ghl Create Invoice | Create a new invoice in GoHighLevel with line items |
| Ghl Create Link | Create a new link/trigger in GoHighLevel |
| Ghl Create Note | Create a new note for a contact in GoHighLevel |
| Ghl Create Opportunity | Create a new opportunity (deal) in a GoHighLevel pipeline |
| Ghl Create Product | Create a new product in GoHighLevel |
| Ghl Create Social Post | Create a new social media post in GoHighLevel |
| Ghl Create Task | Create a new task for a contact in GoHighLevel |
| Ghl Delete Calendar | Delete a calendar from GoHighLevel by ID |
| Ghl Delete Contact | Delete a contact from GoHighLevel by ID |
| Ghl Delete Custom Field | Delete a custom field from GoHighLevel |
| Ghl Delete Event | Delete a calendar event/appointment from GoHighLevel |
| Ghl Delete Link | Delete a link/trigger from GoHighLevel |
| Ghl Delete Media | Delete a media file from GoHighLevel |
| Ghl Delete Note | Delete a note from a contact in GoHighLevel |
| Ghl Delete Opportunity | Delete an opportunity (deal) from GoHighLevel |
| Ghl Delete Product | Delete a product from GoHighLevel |
| Ghl Delete Task | Delete a task from a contact in GoHighLevel |
| Ghl Get Appointment | Get a single appointment/event by ID from GoHighLevel |
| Ghl Get Business | Get a single business by ID from GoHighLevel |
| Ghl Get Calendar | Get a single calendar by ID from GoHighLevel |
| Ghl Get Contact | Get a single contact by ID from GoHighLevel |
| Ghl Get Conversation | Get a single conversation by ID from GoHighLevel |
| Ghl Get Free Slots | Get available free slots for a GoHighLevel calendar within a date range |
| Ghl Get Invoice | Get a single invoice by ID from GoHighLevel |
| Ghl Get Location | Get the current GoHighLevel location details |
| Ghl Get Messages | Get all messages in a GoHighLevel conversation |
| Ghl Get Opportunity | Get a single opportunity (deal) by ID from GoHighLevel |
| Ghl Get Product | Get a single product by ID from GoHighLevel |
| Ghl Get User | Get a single user by ID from GoHighLevel |
| Ghl List Blog Categories | List all blog categories in the GoHighLevel location |
| Ghl List Businesses | List all businesses in the GoHighLevel location |
| Ghl List Calendars | List all calendars in the GoHighLevel location |
| Ghl List Campaigns | List all campaigns in the GoHighLevel location |
| Ghl List Custom Fields | List custom fields for a given object type in GoHighLevel |
| Ghl List Events | List calendar events in GoHighLevel, optionally filtered by calendar and time range |
| Ghl List Form Submissions | List submissions for a specific form in GoHighLevel |
| Ghl List Forms | List all forms in the GoHighLevel location |
| Ghl List Invoices | List all invoices in the GoHighLevel location |
| Ghl List Links | List all links/triggers in the GoHighLevel location |
| Ghl List Media | List all media files in the GoHighLevel location |
| Ghl List Notes | List all notes for a contact in GoHighLevel |
| Ghl List Orders | List all payment orders in the GoHighLevel location |
| Ghl List Pipelines | List all sales pipelines in GoHighLevel |
| Ghl List Products | List all products in the GoHighLevel location |
| Ghl List Social Accounts | List connected social media accounts in GoHighLevel |
| Ghl List Social Posts | List all social media posts in GoHighLevel |
| Ghl List Subscriptions | List all payment subscriptions in the GoHighLevel location |
| Ghl List Survey Submissions | List submissions for a specific survey in GoHighLevel |
| Ghl List Surveys | List all surveys in the GoHighLevel location |
| Ghl List Tasks | List all tasks for a contact in GoHighLevel |
| Ghl List Transactions | List all payment transactions in the GoHighLevel location |
| Ghl List Users | List all users in the GoHighLevel location |
| Ghl List Workflows | List all workflows in the GoHighLevel location |
| Ghl Remove From Campaign | Remove a contact from a campaign in GoHighLevel |
| Ghl Remove Tags | Remove tags from a contact in GoHighLevel |
| Ghl Search Contacts | Search contacts in GoHighLevel by name, email, or phone number |
| Ghl Search Conversations | Search conversations in GoHighLevel by query or contact ID |
| Ghl Search Opportunities | Search opportunities (deals) in GoHighLevel by pipeline, stage, status, or query |
| Ghl Send Invoice | Send an invoice to the contact in GoHighLevel |
| Ghl Send Message | Send a message (SMS, Email, WhatsApp, etc.) via a GoHighLevel conversation |
| Ghl Update Appointment | Update an existing appointment in GoHighLevel |
| Ghl Update Blog Post | Update an existing blog post in GoHighLevel |
| Ghl Update Business | Update an existing business in GoHighLevel |
| Ghl Update Calendar | Update an existing calendar in GoHighLevel |
| Ghl Update Contact | Update an existing contact in GoHighLevel |
| Ghl Update Conversation | Update a conversation in GoHighLevel (star/unstar, set unread count) |
| Ghl Update Custom Field | Update an existing custom field in GoHighLevel |
| Ghl Update Link | Update an existing link/trigger in GoHighLevel |
| Ghl Update Note | Update an existing note for a contact in GoHighLevel |
| Ghl Update Opportunity | Update an existing opportunity (deal) in GoHighLevel |
| Ghl Update Opportunity Status | Update the status of an opportunity in GoHighLevel (open, won, lost, abandoned) |
| Ghl Update Product | Update an existing product in GoHighLevel |
| Ghl Update Task | Update an existing task for a contact in GoHighLevel |
| Ghl Upsert Contact | Create or update a contact in GoHighLevel, matching by email or phone |
| Ghl Void Invoice | Void an invoice in GoHighLevel |