Prerequisites
- A GoHighLevel agency account with permission to install marketplace apps
- A DNCScrub account with API access (your Login ID / API key and a Campaign ID)
Step 1: Install the App
Install the DNCScrub app from the GoHighLevel Marketplace into your agency, then select the sub-accounts where you want to use it.Open the Marketplace Listing
Go to the DNCScrub app installation link:
Install DNCScrub from the GoHighLevel Marketplace
Install to Your Agency
Install the app at the agency level so it is available across your organization.
Step 2: Connect Your DNCScrub Account
After installing, open DNC Settings from the agency sidebar to enter your DNCScrub API credentials. These agency-level credentials apply to every sub-account by default.Check the connection status
The Connection Status panel confirms that GoHighLevel and the DNC Scrub API are connected. Use Refresh Status if you have just completed the install.
Enter your agency credentials
Under DNC Scrub API Credentials, enter:
- DNC Scrub Login ID (API Key) — your DNCScrub API key
- DNC Scrub Campaign ID — the DNCScrub campaign used to scrub contacts
Agency credentials are shared by all sub-accounts. You can override them per sub-account in the next step.
Step 3: Configure a Sub-Account
Scroll to Sub-Account Settings and choose a sub-account (location) from the dropdown to configure it individually.Credential override
Use DNC Credentials Override to point a single sub-account at a different DNCScrub Login ID or Campaign ID. Leave these fields blank to inherit the agency defaults.Scrub behavior
The Scrub Behavior section controls when and how contacts are scrubbed for the selected sub-account:| Setting | What it does |
|---|---|
| Auto-scrub on page load | Automatically scrub when the scrub page opens — no button click needed |
| Auto-scrub new contacts | Automatically scrub contacts when they are created via a workflow |
| Create DNC note on new contacts | Add a pinned DNC Scrub note with a scrub link to new contacts |
| Pin scrub note | Pin the DNC Scrub note to the top of the contact’s notes panel |
| Re-scrub interval (hours) | During a bulk scrub, skip contacts already scrubbed within this many hours (default 24) |
Step 4: Onboard the Sub-Account
Run the Onboarding actions once when you first set up DNC Scrub for a sub-account:- Create Custom Fields — creates the DNC custom fields used to store scrub results on contacts.
- Create Onboarding Notes — adds the initial DNC Scrub notes.
- Note Appearance — set the colors used for the scrub-link note, clean results, and blocked results.
- Bulk Scrub Schedule — enable a recurring scrub of all contacts. The schedule uses cron format and defaults to
0 2 * * *(daily at 2:00 AM UTC).
Scrubbing a Contact
Once a sub-account is onboarded, each contact gets a pinned DNC Scrub note containing a link to the scrub page.
Scrub the numbers
The scrub page lists every phone number on the contact. Select Scrub All Numbers to screen them against DNCScrub.
dnc-blocked) so you can filter them in smart lists and workflows.
Reading a result
Each phone result card includes:| Field | Description |
|---|---|
| Result Code | The DNCScrub status code (for example, Y = clean, D = Do Not Call) |
| Callable | Whether the number is safe to call (Yes — Safe to call or NO — Do Not Call) |
| Line Type | The line type, such as VoIP, Wireless, or Landline |
| Carrier | The carrier name when available |
| Reason | Why the number was flagged, such as a National DNC registration date |
Taking Action on a Result
From the scrub results you can act on a number directly:- Re-Scrub — run the scrub again to refresh the result.
- Add to IDNC — add the number to your Internal Do Not Call list.
- Add EBR — record an Existing Business Relationship so the number remains callable under that exemption.
- EBR Type — the relationship and its duration, such as Sale (18 months).
- Date of Last Contact — when you last did business with the contact.
- Reference — an optional reference number.
Automated and Bulk Scrubbing
Beyond scrubbing contacts one at a time, you can automate the process:- Enable Auto-scrub new contacts (Step 3) to scrub contacts as workflows create them.
- Enable Auto-scrub on page load (Step 3) to scrub automatically when the scrub page opens.
- Enable the Bulk Scrub Schedule (Step 4) to re-scrub all contacts on a recurring cron schedule, skipping any contact scrubbed within the Re-scrub interval.
Note Link Security
Every DNC Scrub note link is signed with a private key unique to your agency, so only scrub links your account generates are accepted. You can view and rotate this key under DNC Settings → Note Link Security, where it is shown masked (for example,••••••••abcd).
Rotate the key if you believe a scrub link has been shared outside your team.
Rotate the key
Select ↻ Rotate next to the signing key, then confirm. The key is replaced immediately.
Offboarding
To remove DNC Scrub data from a sub-account, use the Offboarding actions in DNC Settings:- Delete All DNC Notes
- Delete Custom Fields