Skip to content
Raise a Ticket
Contact us
  • There are no suggestions because the search field is empty.

How to Integrate GoHighLevel with Pearl Diver

Authorizing GoHighLevel via Pearl Diver dashboard and accessing Pearl Diver contacts in GoHighLevel

By integrating Pearl Diver with GoHighLevel, businesses can leverage Pearl Diver leads to target high-value prospects. This enables you to run highly personalized email marketing campaigns and retarget visitors based on behavior and intent data collected on their website.
 
✅Prerequisites
Before you start configuring, make sure you have the following:
  1. A GoHighLevel account and valid login credentials
  2. Ensure you have connected an audience for the data you would like to send through the GoHighLevel integration, and this audience has the 'GoHighLevel' action selected
Step 1: Authorize GoHighLevel Integration
  • Log in to your Pearl Diver dashboard
  • Click the + icon next to Actions on the right hand side of the dashboard home page
  • Click on GoHighLevel in the left hand panel
  • Click Authorize - this will prompt you to log in to your GoHighLevel account

If you encounter issues during authorisation, try using a private/incognito browser window.

Step 2. Log in to GoHighLevel Integration

  1. A new window will open to authorize your GoHighLevel account and choose a sub account if needed
edbsn4d4a76d82bb18db676d23ca4e1e374044a4f35a780bdaa920030d01fee6624ee81762247f8884a4bfec5c9cdf3535e70
 
 
🔓The Pearl Diver integration asks permission to access the following in GoHighLevel:
  1. Opportunities (opportunities.readonly opportunities.write): This permission is required to create and update opportunity contacts in GoHighLevel
  2. Contacts (contacts.readonly contacts.write): This permission is required to create and update lead contacts in GoHighLevel.
  3. Users (users.readonly): This permission is required by GoHighLevel for the authorization  
✅These permissions are so the integration can create a Pearl Diver list to create and sync and update in GoHighLevel. The integration will never delete contacts. To proceed, click Allow.
 

Step 3: Choose mapping mode (Many : 1 vs 1 : 1)

By default, Pearl Diver uses Many : 1 mapping, meaning all audiences sync into the single Pearl Diver contact list without tagging. To switch to 1 : 1 tag‑based mapping:

  1. In Pearl Diver, navigate to Actions and select the GoHighLevel integration card.

  2. Under Audience Mapping Settings, change the mode from Many : 1 to 1 : 1 (Tag‑Based Mapping).

  3. Click Update. A message will confirm the change.

 81a2fa59-6448-4387-8633-40d7327fc033

How 1 : 1 tag‑based mapping works

  1. In the next sync, Pearl Diver checks existing GoHighLevel tags. For every audience that has been created or modified—and for any new contacts added to existing audiences in the last 30 minutes, it creates a new tag in GoHighLevel named:

    PDV | Audience Name

    (Tags aren’t recreated if they already exist.)

  2. Contacts are still added to the Pearl Diver list, but each contact receives one or more tags corresponding to the audiences it belongs to. A contact appearing in multiple audiences will have multiple tags.

  3. Switching back to Many : 1 doesn’t remove tags from existing contacts; it simply stops adding new ones. You can continue to use existing tags for segmentation.

Pearl Diver automatically maps core contact fields to GoHighLevel. You can customise this mapping through the Pearl Diver REST API or via Zapier if you need additional fields.

Pearl Diver field

 

GoHighLevel field

 

Notes

 

First name

First name

Direct mapping

Last name

Last name

Direct mapping

Email address

Email

Direct mapping

Phone*

Phone

Uses the first non‑empty value among company, personal, mobile and direct phone numbers

Address**

Address

Uses the first non‑empty personal, company or professional address

Job title

Title

Direct mapping

Company name

Business name

Direct mapping

Company domain

Website

Direct mapping

(no field)

Contact Source

Always set to PearlDiver

*For phone numbers the integration picks the first available number in this order: company, personal, mobile, then direct phone.

** For addresses the integration chooses the first available from personal, company, then professional addresses.

If you need additional fields (e.g., LinkedIn URL, industry, or custom properties), you can build a custom integration via the Pearl Diver REST API or Zapier.

❓Where to find Pearl Diver contacts in your GoHighLevel account
 
1. Sign in to your GoHighLevel account and click on Contacts 
 
 
2.  View all contacts synced from the Pearl Diver application