How can we help you?
How to Integrate GoHighLevel With Pearl Diver
Authorize GoHighLevel from your Pearl Diver dashboard, choose Many:1 or 1:1 tag-based mapping, then find your synced contacts.

Connecting Pearl Diver to GoHighLevel lets you target high-value prospects with your Pearl Diver leads, and run personalized email campaigns and retargeting based on the behavior and intent data collected on your website.

✅ Prerequisites

  • A GoHighLevel account and valid login credentials.
  • An audience connected in Pearl Diver for the data you want to send, with the "GoHighLevel" action selected.

Connect GoHighLevel to Pearl Diver

  1. Log in to Pearl Diver.
  2. Click the + icon next to Actions, on the right side of the dashboard homepage.
  3. Click GoHighLevel in the left-hand navigation.
  4. Click Authorize. This prompts you to log in to your GoHighLevel account.
Note: If you run into issues during authorization, try a private or incognito browser window.

A new window opens to authorize your GoHighLevel account and choose a sub-account if needed.

GoHighLevel authorization window with sub-account selection GoHighLevel sub-account confirmation screen

🔐 What Pearl Diver asks GoHighLevel for

  • Opportunities (opportunities.readonly, opportunities.write) — needed to create and update opportunity contacts in GoHighLevel.
  • Contacts (contacts.readonly, contacts.write) — needed to create and update lead contacts in GoHighLevel.
  • Users (users.readonly) — required by GoHighLevel for the authorization itself.

These permissions let the integration create a Pearl Diver list and sync it to GoHighLevel. The integration never deletes contacts. Click Allow to proceed.

Choose your mapping mode

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

  1. In Pearl Diver, go 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 confirms the change. Mapping mode change confirmation message

How 1:1 tag-based mapping works

  • On the next sync, Pearl Diver checks existing GoHighLevel tags. For every audience created or modified, and any new contacts added to existing audiences, in the last 30 minutes, it creates a tag named PDV | Audience Name (tags aren't recreated if they already exist).
  • Contacts still go into the Pearl Diver list, but each also gets one or more tags matching the audiences it belongs to. A contact in multiple audiences gets multiple tags.
  • Switching back to Many:1 doesn't remove tags from existing contacts, it just stops adding new ones. You can keep using existing tags for segmentation.

Default field mapping

Pearl Diver automatically maps core contact fields to GoHighLevel. For extra fields, such as a LinkedIn URL, industry, or custom properties, build a custom integration through Zapier or the Pearl Diver REST API.

Default Pearl Diver to GoHighLevel field mapping

Phone number picks the first available of company, personal, mobile, then direct. Address picks the first available of personal, company, then professional.

Find your Pearl Diver contacts in GoHighLevel

  1. Sign in to GoHighLevel and click Contacts. Contacts menu item in GoHighLevel
  2. View all contacts synced from Pearl Diver. Contacts synced from Pearl Diver in GoHighLevel Detail view of a Pearl Diver-synced contact in GoHighLevel

Need help? Visit the Pearl Diver Help Centre or book a support session with the team.

Did this answer your question?
Ask AI
Responses are generated using AI and may contain mistakes.
How can I help you?
Ask me anything about our product. I can help you find answers across the knowledge base.
Ask a question...Ctrl+I