GoHighLevel CRM Integration

HiLucy integrates with GoHighLevel (GHL) to automatically push WooCommerce order data into your CRM. Every booking becomes a contact and, optionally, a pipeline opportunity -- giving your sales and marketing teams real-time visibility into guest activity.

What Gets Synced

| Data | Direction | Trigger | |------|-----------|---------| | Guest contact info (name, email, phone, address) | HiLucy -> GHL | New order created | | Order details (line items, totals, coupons) | HiLucy -> GHL | New order created | | Order status changes | HiLucy -> GHL | Status transitions you select | | Pipeline opportunity | HiLucy -> GHL | New order (if pipeline configured) | | Contact tag | HiLucy -> GHL | Every synced order |

Setup Steps

1. Get Your GoHighLevel Credentials

From your GoHighLevel sub-account:

1. Navigate to Settings -> Business Profile and copy your Location ID
2. Go to Settings -> API Keys and generate a location-level API key

Use a location-level key (not agency-level) so that contacts and opportunities stay scoped to the correct sub-account.

2. Configure HiLucy

In your WordPress admin:

1. Go to Settings -> HiLucy GoHighLevel
2. Check Enable syncing
3. Paste your API key and Location ID
4. (Optional) Enter a Pipeline ID and Stage ID to create an opportunity for every order
5. (Optional) Set an Order tag -- this tag is applied to every synced contact and can trigger GHL workflows
6. Click Save GoHighLevel settings

3. Choose Delivery Method

HiLucy supports two delivery methods that can run independently or together:

• API -- Directly creates or updates contacts and opportunities via the GoHighLevel REST API
• Webhook -- Sends the full order payload to a GHL inbound webhook URL, useful if you prefer not to expose an API key or want to trigger a custom GHL workflow

Enter a Workflow webhook URL in the settings if you want to use the webhook method.

4. Select Status Triggers

By default, HiLucy syncs when an order is first created. You can also re-sync on specific status transitions (e.g., "completed", "refunded") to trigger stage-based automations in GoHighLevel. Check the statuses you want to track under Statuses to sync again.

Data Flow Details

When a WooCommerce order is placed or changes status:

1. HiLucy builds a payload containing the guest's contact info, order line items, totals, coupons, and metadata
2. If API delivery is enabled, HiLucy creates or updates the contact in GHL and optionally opens a pipeline opportunity
3. If webhook delivery is enabled, the full payload is POSTed to your GHL workflow trigger
4. A deduplication check prevents the same order/status combination from syncing twice

Monitoring

The settings page displays a Latest sync attempt panel showing the last order synced, the event type, and whether each delivery method succeeded or failed. Check this panel if you suspect sync issues.

Troubleshooting

Orders not appearing in GoHighLevel?

1. Verify that Enable syncing is checked and at least one delivery method is configured
2. Confirm your API key is a location-level key (not expired or revoked)
3. Check the WordPress debug log for error messages containing "GoHighLevel"

Duplicate contacts?

GoHighLevel matches contacts by email. If a guest places multiple orders with different email addresses, separate contacts will be created. Merge them manually in GHL or standardize email collection at checkout.

Webhook not firing?

Ensure the webhook URL starts with https://services.leadconnectorhq.com/hooks/ and that the corresponding GHL workflow is published and active.