> ## Documentation Index
> Fetch the complete documentation index at: https://docs.landerlab.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Set Up GoHighLevel Integration

> Learn how to connect GoHighLevel to your LanderLab landing pages to sync leads as contacts and trigger workflows in real time.

<Frame>
  <img src="https://mintcdn.com/landerlab-babdc23f/z2Nyn8JYMMirC6py/images/LL-GHL.png?fit=max&auto=format&n=z2Nyn8JYMMirC6py&q=85&s=3a555558695f500bfe94a2352d94ac18" alt="LL GHL" width="1200" height="600" data-path="images/LL-GHL.png" />
</Frame>

## What is GoHighLevel and Why Use This Integration?

GoHighLevel (GHL) is an all-in-one CRM and marketing automation platform used by agencies and performance marketers to manage contacts, pipelines, and automated workflows. When you connect GoHighLevel to a LanderLab landing page, every lead that submits your form is instantly sent to your GHL sub-account as a new contact. You can also choose to trigger a GHL workflow at the same time, enrolling the lead into any automation you have set up.

The GoHighLevel connection works in two stages. First you add your GoHighLevel sub-account to LanderLab using your Location ID and API Key. Then you connect that account to your landing page and configure the action, workflow, tags, and field mapping.

<Note>
  GoHighLevel integrations **are saved globally in your account**. Once you add your GHL sub-account, you can reuse it across multiple landing pages without entering your credentials again.
</Note>

***

## Before You Begin

You will need two things from your GoHighLevel account:

**Location ID**

The Location ID is the unique identifier for your GHL sub-account. To find it:

1. Log in to your GoHighLevel sub-account
2. Go to **Settings** in the lower right corner
3. Click **Business Profile** in the left sidebar
4. Your **Location ID** is displayed on that page

**API Key**

LanderLab requires a GHL API key with the following scopes enabled:

* `workflows.read`
* `contacts.read`
* `contacts.write`
* `customFields.readonly`
* `customFields.write`

To generate an API key with these scopes, go to your GHL sub-account, navigate to **Settings**, click **Private Integrations**, and create a new private integration with the scopes listed above. Copy the token generated.

<Warning>
  GHL no longer allows generating new API keys from the standard Agency or Sub-account settings for accounts that have not previously used them. Use **Private Integrations** to generate your token instead.
</Warning>

***

## How to Add GoHighLevel

### Stage 1: Add Your GoHighLevel Account

<Steps>
  <Step title="Go to your landing page">
    Navigate to **Landing Pages** and click the **name of the landing page** where you want to add GoHighLevel.
  </Step>

  <Step title="Open the Integrations tab">
    Click **Add Integration** to open the integrations panel.
  </Step>

  <Step title="Select GoHighLevel">
    From the list of available integrations, find **GoHighLevel** (labeled as "Sync leads with GoHighLevel as they come in") and click on it.
  </Step>

  <Step title="Fill in your account credentials">
    Enter the following details:

    | Field           | Description                                                                                        |
    | :-------------- | :------------------------------------------------------------------------------------------------- |
    | **Name**        | A label to identify this account connection (e.g. "GHL Main Account").                             |
    | **Location ID** | The unique ID of your GHL sub-account. Found under **Settings > Business Profile** in GoHighLevel. |
    | **API Key**     | Your GoHighLevel Private Integration token with the required scopes enabled.                       |
  </Step>

  <Step title="Click Add GoHighLevel">
    Click **Add GoHighLevel** to authenticate and save your account. LanderLab will verify the credentials and connect to your GHL sub-account.
  </Step>
</Steps>

***

### Stage 2: Configure Action, Workflow, Tags, and Field Mapping

Once your account is added, the wizard moves to the integration configuration.

#### Step 1: Configure Action and Tags

<Steps>
  <Step title="Set a name for this integration">
    Give this integration a recognizable label (e.g. "GHL - Health Insurance Leads"). This helps you identify it in the integrations list on your landing page.
  </Step>

  <Step title="Select an Action">
    Choose what should happen in GoHighLevel when a lead is submitted. You have two options:

    | Action                        | Description                                                                                                                                                                    |
    | :---------------------------- | :----------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
    | **Save contact**              | Creates the lead as a new contact in your GHL sub-account. No workflow is triggered.                                                                                           |
    | **Save and trigger workflow** | Creates the contact and immediately enrolls them in a GHL workflow you select. Use this to kick off automations like email sequences, SMS follow-ups, or pipeline assignments. |
  </Step>

  <Step title="Select a Workflow (if applicable)">
    If you selected **Save and trigger workflow**, a **Workflow** dropdown will appear. Select the GHL workflow you want to trigger for each new lead. The workflow must already exist in your GoHighLevel sub-account.
  </Step>

  <Step title="Add Tags (optional)">
    In the **Tags** field, pick from existing tags or type to create new ones. Tags are applied to every contact created through this landing page and are useful for segmenting leads by campaign, offer, or traffic source.
  </Step>

  <Step title="Click Continue">
    Click **Continue** to move to the field mapping step.
  </Step>
</Steps>

#### Step 2: Map Your Fields

<Steps>
  <Step title="Map your form fields to GoHighLevel contact properties">
    You will see a list of all fields from your landing page form on the left, and a dropdown to select the matching GoHighLevel contact property on the right.

    Map each form field to the corresponding GHL property. At minimum, map **Email** or **Phone** as GHL requires at least one to create a contact.

    | Form Field          | GoHighLevel Property |
    | :------------------ | :------------------- |
    | Full Name           | Full Name            |
    | Email               | Email\*              |
    | Phone Number        | Phone                |
    | (other form fields) | Select field         |

    Fields you do not map will not be sent to GoHighLevel. Use the checkboxes on the left to include or exclude individual fields.

    <Tip>
      LanderLab also includes system fields like **LL Lander URL**, **LL Visitor IP**, **LL Visitor User Agent**, **LL Submission Time UTC**, and **LL Variant ID**. You can map these to custom fields in GoHighLevel if you want to store tracking data alongside contact records.
    </Tip>
  </Step>

  <Step title="Click Continue">
    Click **Continue** to move to the review step.
  </Step>
</Steps>

#### Step 3: Review and Connect

<Steps>
  <Step title="Review your integration">
    The final step shows a full summary of your GoHighLevel integration including the integration name, selected action, workflow (if applicable), applied tags, and all mapped fields. Review everything carefully before activating.

    If anything looks wrong, click **Back** to return to the previous steps and make changes.
  </Step>

  <Step title="Click Connect GoHighLevel">
    Click **Connect GoHighLevel** to save and activate the integration. From this point on, every lead submitted on this landing page will be synced to your GoHighLevel sub-account in real time.
  </Step>
</Steps>

***

## Tips for GoHighLevel Integration

* **Email or phone is required** - GoHighLevel needs at least one of these to create a contact. Make sure your form collects at least one and that it is mapped.
* **Existing contacts are updated** - If a lead submits with an email or phone that already exists in GHL, the existing contact record will be updated rather than creating a duplicate.
* **Use workflows for automations** - If you want new leads to automatically receive a follow-up SMS, be added to a pipeline, or start an email sequence, select **Save and trigger workflow** and choose the relevant workflow.
* **Make sure your workflow is active** - GHL will only enroll contacts into workflows that are published and active. A paused or draft workflow will not trigger even if it is selected here.
* **Test with a real submission** - After connecting, submit a test lead on your landing page and verify the contact appears in your GoHighLevel sub-account under **Contacts** within a few seconds. If you triggered a workflow, check the contact's workflow enrollment to confirm it started.