Skip to main content

GoHighLevel

Connect GoHighLevel (GHL) to synchronize contacts, opportunities, campaign engagement activity, and outbound workflows between Ragworks and your CRM.

Overview​

The GoHighLevel datasource enables Ragworks to:

  • Sync contacts and opportunities
  • Push outbound engagement activity into GHL
  • Track campaign interactions
  • Centralize CRM updates and conversations
  • Automate lead lifecycle workflows

Ragworks connects to GoHighLevel using a Private Integration Token (PIT) with restricted scopes.

Before You Begin​

Before connecting GoHighLevel, ensure you have:

  • Access to a GoHighLevel account with admin permissions
  • Permission to create private integrations
  • Access to your Location ID

Create a Private Integration in GoHighLevel​

Step 1: Open Private Integrations​

  1. Log in to your GoHighLevel account.
  2. Navigate to:
Settings → Private Integrations
  1. Click Create Integration.
GHL Private Integrations

Step 2: Configure Integration Scopes​

Create the integration with restricted scopes.

Recommended scopes:

  • View Contacts
  • Edit Contacts
  • View Opportunities
  • Edit Opportunities
  • View Locations
  • View Custom Fields
  • Edit Custom Fields

These permissions allow Ragworks to synchronize contacts, opportunities, and engagement workflows securely.

GHL Scopes

Step 3: Copy the Private Integration Token​

After creating the integration:

  1. Copy the generated Private Integration Token (PIT).
  2. Store it securely.

You will use this token inside Ragworks during datasource setup.

warning

Treat the Private Integration Token like a password. Do not share it publicly or expose it in frontend applications.

Find Your Location ID​

The Location ID can typically be found:

  • In the browser URL while inside a location
  • Or within GoHighLevel location settings

Example:

https://app.gohighlevel.com/v2/location/LOCATION_ID/dashboard

Copy the LOCATION_ID value.

Connect GoHighLevel in Ragworks​

Step 1: Navigate to Connectors​

  1. Open the Ragworks dashboard.
  2. From the left sidebar, click Connectors.
  3. Select CRM Provider.

Step 2: Choose CRM Provider​

  1. Click Add Account
  2. Select GoHighLevel from the CRM provider list.
Choose CRM Provider

Step 3: Enter GHL Credentials​

Fill in the required fields:

FieldRequiredDescription
Account NameYesA label for this GHL connection (e.g., GoHighLevel Account)
DescriptionNoOptional note (e.g., Primary CRM for sales)
Private Integration TokenYesThe token generated in GHL Settings → Private Integrations
Location IDYesThe GHL location ID from the URL or location settings

Then click Connect Source.

GHL Connect Form

Connection Validation​

During setup, Ragworks validates the integration by:

  • Creating a temporary test contact
  • Verifying API access permissions
  • Removing the temporary contact after successful validation

This helps ensure the integration is configured correctly before syncing production data.

What Gets Synced​

Once connected, Ragworks can synchronize:

  • Contacts
  • Opportunities
  • Campaign engagement activity
  • Conversation updates
  • Lead lifecycle activity
  • CRM workflow updates

This allows outbound actions performed inside Ragworks to remain visible and centralized inside GoHighLevel.

  • Use restricted scopes whenever possible and only grant permissions required for your workflows.

  • Use dedicated private integrations for production environments to simplify credential management and auditing.

Troubleshooting

If the connection fails:

  • Verify the Private Integration Token is valid
  • Confirm required scopes are enabled
  • Ensure the Location ID is correct
  • Verify the integration is active
  • Retry the connection process