GoHighLevel / LeadConnector Integration Guide
This guide covers all GoHighLevel (also called LeadConnector) actions available in TexAu.
All LeadConnector actions in TexAu cost 0 credits. You only pay for the credits on your GoHighLevel side.
Before you begin
- A GoHighLevel account is required. Sign up at gohighlevel.com.
- Your GoHighLevel API key is at Settings > Integrations > API Key inside GoHighLevel.
- In TexAu, go to Settings > Integrations, find LeadConnector or GoHighLevel, enter your API key, and click Save.
Contact actions
Create Contact
Creates a new contact in GoHighLevel.
Input:
- Email (optional -- email or phone is required)
- Phone (optional -- email or phone is required)
- First Name, Last Name (optional)
- Address (optional)
- Tags (optional -- comma-separated list)
- Company Name (optional)
Output:
- Contact ID
- Creation status
Upsert Contact
Creates a new contact or updates an existing one if a match is found by email or phone.
Input:
- Email or Phone (required for matching)
- Fields to update
Output:
- Contact ID
- Upsert action (created or updated)
Get Contact
Returns details for a single contact by ID.
Input:
- Contact ID (required)
Output:
- All contact fields including custom fields
Update Contact
Updates fields on an existing contact.
Input:
- Contact ID (required)
- Fields to update
Output:
- Update status
Delete Contact
Deletes a contact from GoHighLevel.
Input:
- Contact ID (required)
Output:
- Deletion status
Search Contacts
Searches contacts by name, email, or phone.
Input:
- Search query
Output:
- Array of matching contacts
Add Tag
Adds one or more tags to a contact.
Input:
- Contact ID (required)
- Tags (required -- one tag or comma-separated list)
Output:
- Tag addition status
Remove Tag
Removes one or more tags from a contact.
Input:
- Contact ID (required)
- Tags to remove
Output:
- Removal status
Business / Company actions
Create Business/Company
Creates a new business record.
Input:
- Name (required)
- Website (optional)
- Phone (optional)
- Email (optional)
- Address (optional)
- Description (optional)
Output:
- Business ID
Get Business/Company
Returns details for a specific business record.
Input:
- Business ID (required)
Output:
- All business fields
Update Business/Company
Updates an existing business record.
Input:
- Business ID (required)
- Fields to update
Output:
- Update status
Delete Business/Company
Deletes a business record.
Input:
- Business ID (required)
Output:
- Deletion status
Get Businesses by Location
Returns all businesses associated with a specific sub-account (location).
Input:
- Location ID (required)
Output:
- Array of business records
Opportunity actions
Create Opportunity
Creates a new opportunity (deal) in a pipeline.
Input:
- Pipeline ID (required)
- Stage ID (required)
- Name (required)
- Contact ID (optional)
- Monetary value (optional)
- Status (optional)
Output:
- Opportunity ID
Upsert Opportunity
Creates or updates an opportunity based on matching criteria.
Input:
- Pipeline ID (required)
- Contact ID (required)
- Fields
Output:
- Opportunity ID
- Upsert action
Get Opportunity
Returns details for a specific opportunity.
Input:
- Opportunity ID (required)
Output:
- All opportunity fields
Update Opportunity
Updates an existing opportunity.
Input:
- Opportunity ID (required)
- Fields to update
Output:
- Update status
Update Opportunity Status
Changes the status of an opportunity (open, won, lost, abandoned).
Input:
- Opportunity ID (required)
- Status (required)
Output:
- Update status
Delete Opportunity
Deletes an opportunity.
Input:
- Opportunity ID (required)
Output:
- Deletion status
Search Opportunities
Searches opportunities by contact or pipeline.
Input:
- Search query or Pipeline ID
Output:
- Array of matching opportunities
Appointment and calendar actions
Create Appointment
Creates a new appointment.
Input:
- Calendar ID (required)
- Contact ID or email (required)
- Start date/time (required)
- End date/time (required)
- Title (optional)
Output:
- Appointment ID
Get Appointment
Returns details for a specific appointment.
Input:
- Appointment ID (required)
Output:
- Appointment details
Get Calendars
Returns all calendars in the GoHighLevel account.
Input: None
Output:
- Array of calendar IDs and names
Create Calendar
Creates a new calendar.
Input:
- Name (required)
- Location ID (required)
- Timezone (optional)
Output:
- Calendar ID
Get Calendar Events
Returns events for a specific calendar in a date range.
Input:
- Calendar ID (required)
- Start date (required)
- End date (required)
Output:
- Array of calendar events
Conversation and messaging actions
Get Conversation
Returns a conversation record by ID.
Input:
- Conversation ID (required)
Output:
- Conversation details including contact, channel, and messages
Search Conversations
Searches conversations by contact or keyword.
Input:
- Search query
Output:
- Array of conversations
Get Conversation Messages
Returns messages within a specific conversation.
Input:
- Conversation ID (required)
Output:
- Array of messages with content, timestamp, and direction (inbound/outbound)
Send Message
Sends a message to a contact in GoHighLevel.
Input:
- Contact ID or Conversation ID (required)
- Message type (SMS, email, etc.)
- Message body (required)
Output:
- Message ID
- Send status
Add Inbound Message
Adds an inbound message record to a conversation.
Input:
- Conversation ID (required)
- Message body (required)
Output:
- Message ID
Update Message Status
Updates the delivery status of a message.
Input:
- Message ID (required)
- Status (required)
Output:
- Update status
Workflow and task actions
Get Workflows
Returns all automation workflows in GoHighLevel.
Input: None
Output:
- Array of workflow IDs and names
Get All Tasks
Returns all tasks.
Input:
- Contact ID (optional -- filter by contact)
Output:
- Array of tasks with due date, title, and status
Sub-account / location actions
Get Sub-Account/Location
Returns details for a specific GoHighLevel sub-account (location).
Input:
- Location ID (required)
Output:
- Sub-account name, address, phone, email, timezone
Search Locations
Searches sub-accounts by name.
Input:
- Search query (required)
Output:
- Array of matching sub-accounts
Custom fields and values
Get Custom Fields
Returns all custom field definitions for contacts in a sub-account.
Input:
- Location ID (optional)
Output:
- Array of field keys and types
Get Custom Values
Returns the custom values (snippets) set in a sub-account.
Input:
- Location ID (optional)
Output:
- Array of custom keys and values
Get Tags
Returns all tags available in the account.
Input: None
Output:
- Array of tag names
Get Pipelines
Returns all opportunity pipelines.
Input: None
Output:
- Array of pipeline IDs and names
Troubleshooting
Create Contact fails with no error but the contact does not appear. GoHighLevel may have silently rejected the record due to a validation issue. Confirm that at least one of email or phone is provided.
Custom fields are not saving on Create Contact. Custom fields in GoHighLevel use internal key names (not the display names shown in the UI). Use Get Custom Fields to retrieve the exact field keys, then map them in the action configuration.
The API returns "Location not found". GoHighLevel sub-accounts (locations) each have a unique ID. Confirm you are using the Location ID, not the location name or account name.
Opportunities are being created without a contact. Contact ID is optional in Create Opportunity but assignments are recommended. If the Contact ID column is empty for some rows, those opportunities will be created unassigned.