This guide walks you through connecting RealValidito to GoHighLevel and setting up automated phone validation and DNC screening directly inside your GHL workflows.


Step 1: Create a RealValidito Account

If you don’t have a RealValidito account yet, create one for free. You’ll receive 1,000 free Phone Lookup credits and 100 free DNC Lookup credits with no credit card required.


Step 2: Install RealValidito from the GHL Marketplace

  1. Go to the GoHighLevel App Marketplace and search for RealValidito, or use this direct install link: Install RealValidito.
  2. Click Install. You’ll be redirected to RealValidito’s secure account linking page.
  3. Log in with your RealValidito account credentials and click Link Account.
  4. You’ll see a GoHighLevel Connected! confirmation. Authentication is automatic using your GHL location ID — no API key required.
  5. RealValidito will automatically create 13 custom contact fields in your sub-account under the Additional Info folder. No manual field setup is needed.

Step 3: Import Pre-Built Workflows

RealValidito includes 3 pre-built workflows that are ready to use with no manual setup required.

3.1 Import the Snapshot into Your Agency Account

  1. Log in to your RealValidito account.
  2. Go to Account Settings (top right menu → API Credentials) and scroll down to the GoHighLevel & Zapier Integration section. Click the Import Pre-Built Workflow button.
  3. You will be prompted: “Do you want to import the RealValidito – GHL Integration V2.0 to this account?” — click Yes, import now.
  4. The snapshot will be imported into your GHL agency account’s Imported Snapshots library.

3.2 Push the Snapshot to Your Sub-Account

  1. In GHL, go to your Agency Dashboard and open the sub-account where you want to use RealValidito.
  2. Click Actions (top right) and select Load snapshot.
  3. In the snapshot picker, select Imported – RealValidito – GHL Integration V2.0 and click Proceed.
  4. On the next screen, you will see all assets to push. Make sure Workflow (3/3) is selected and click Proceed.
  5. If prompted about conflicts, type CONFIRM and click Proceed.
  6. The snapshot will be pushed to the sub-account. You will be notified when complete.

3.3 Publish the Workflow You Need

All 3 workflows are imported as Draft by default. Go to Automation → Workflows in your sub-account and publish only the workflow(s) you need:

  • RealValidito Phone Lookup — validates phone number format, line type, carrier, and location. Deducts 1 Phone Lookup credit per contact.
  • RealValidito DNC Lookup — screens against Federal DNC, State DNC (Texas, Florida, Pennsylvania, Indiana, Colorado, Wyoming), and TCPA litigator lists. Deducts 1 DNC Lookup credit per contact.
  • RealValidito Phone & DNC Lookup — runs both lookups in one step. Deducts 1 Phone Lookup credit + 1 DNC Lookup credit per contact.

Important: Do not publish more than one workflow at the same time unless you specifically need all of them. Publishing multiple workflows simultaneously will multiply your credit usage — for example, publishing all 3 workflows will consume 2 Phone credits and 2 DNC credits per contact instead of 1 each.


Step 4: Map Custom Fields in the Workflow

Due to a GoHighLevel platform limitation, the Update contact field step in each workflow requires a one-time manual field mapping after import. The variable values are pre-filled correctly — you only need to select the matching RV field from the dropdown for each row.

Open the workflow, click on the Update contact field step, and map each field as follows:

RealValidito Phone & DNC Lookup

Pre-filled Variable Select Field
{{rv_phone_dnc_lookup.1.is_valid}} RV Is Valid
{{rv_phone_dnc_lookup.1.line_type}} RV Line Type
{{rv_phone_dnc_lookup.1.carrier}} RV Carrier
{{rv_phone_dnc_lookup.1.network_domain}} RV Network Domain
{{rv_phone_dnc_lookup.1.zip}} RV ZIP
{{rv_phone_dnc_lookup.1.city}} RV City
{{rv_phone_dnc_lookup.1.state}} RV State
{{rv_phone_dnc_lookup.1.country}} RV Country
{{rv_phone_dnc_lookup.1.timezone}} RV Timezone
{{rv_phone_dnc_lookup.1.is_tcpa}} RV Is TCPA
{{rv_phone_dnc_lookup.1.is_dnc}} RV Is Federal DNC
{{rv_phone_dnc_lookup.1.is_state_dnc}} RV Is State DNC
{{rv_phone_dnc_lookup.1.state_dnc_reason}} RV State DNC Reason

RealValidito Phone Lookup

Pre-filled Variable Select Field
{{rv_phone_dnc_lookup.1.is_valid}} RV Is Valid
{{rv_phone_dnc_lookup.1.line_type}} RV Line Type
{{rv_phone_dnc_lookup.1.carrier}} RV Carrier
{{rv_phone_dnc_lookup.1.network_domain}} RV Network Domain
{{rv_phone_dnc_lookup.1.zip}} RV ZIP
{{rv_phone_dnc_lookup.1.city}} RV City
{{rv_phone_dnc_lookup.1.state}} RV State
{{rv_phone_dnc_lookup.1.country}} RV Country
{{rv_phone_dnc_lookup.1.timezone}} RV Timezone

RealValidito DNC Lookup

Pre-filled Variable Select Field
{{rv_phone_dnc_lookup.1.is_tcpa}} RV Is TCPA
{{rv_phone_dnc_lookup.1.is_dnc}} RV Is Federal DNC
{{rv_phone_dnc_lookup.1.is_state_dnc}} RV Is State DNC
{{rv_phone_dnc_lookup.1.state_dnc_reason}} RV State DNC Reason

Click Save action after mapping all fields. This is a one-time setup per workflow.


Step 5: Test Your Workflow

  1. Create a new contact with a real US or Canada phone number.
  2. The workflow will trigger automatically within seconds.
  3. Go to Execution Logs to confirm all steps show Executed status.
  4. Open the contact record and scroll to the Additional Info section to see the RV fields populated with lookup results.
  5. Check the contact tags to confirm the correct tags were applied based on the result.

Custom Fields Created Automatically

After installing RealValidito, the following 13 custom fields are automatically created in your sub-account under the Additional Info folder:

  • RV Is Valid — true if the phone number format is valid
  • RV Line Type — Mobile, Landline, VoIP, or Toll-Free
  • RV Carrier — carrier name with real-time LNP detection
  • RV Network Domain — carrier network domain
  • RV State — state associated with the number
  • RV City — city associated with the number
  • RV ZIP — ZIP code associated with the number
  • RV Country — country associated with the number
  • RV Timezone — timezone associated with the number
  • RV Is TCPA — true if the number is a known TCPA litigator
  • RV Is Federal DNC — true if listed on the Federal Do Not Call registry
  • RV Is State DNC — true if listed on a State DNC list
  • RV State DNC Reason — the specific state DNC list matched (e.g. Texas-DNC, Florida-DNC)

Tags Applied Automatically

The pre-built workflows apply the following tags to contacts based on lookup results:

DNC Tags

  • tcpa-litigator — number is a known TCPA litigator (highest priority)
  • federal-dnc — number is on the Federal Do Not Call registry
  • state-dnc — number is on a State DNC list (Texas, Florida, Pennsylvania, Indiana, Colorado, Wyoming)
  • dnc-clean — number passed all DNC checks (not on any list)

Phone Tags

  • invalid-phone — number has an invalid format
  • mobile-number — number is a mobile line
  • landline-number — number is a landline (SMS will not be delivered)
  • voip-number — number is a VoIP line (TCPA risk for auto-dialing)
  • toll-free-number — number is a toll-free line
  • phone-verified — number passed all phone checks

A contact can receive multiple tags. For example, a valid mobile number on both the Federal and State DNC lists will receive: federal-dnc, state-dnc, and mobile-number.


Available Workflow Actions

  • Phone Lookup — validates the phone number and returns line type, carrier, active/inactive status, location data, timezone, and network domain. Deducts 1 Phone Lookup credit per contact.
  • DNC Lookup — screens the number against the Federal DNC registry, State DNC lists (Texas, Florida, Pennsylvania, Indiana, Colorado, Wyoming), and TCPA litigator database. Deducts 1 DNC Lookup credit per contact.
  • Phone & DNC Lookup — runs both Phone Lookup and DNC Lookup in a single workflow step. Deducts 1 Phone Lookup credit + 1 DNC Lookup credit per contact.

Troubleshooting

RealValidito doesn’t show up in Add Action search

Make sure you completed the installation step and your RealValidito account is linked. Try reinstalling the app from the GHL Marketplace.

Custom fields show no data after workflow runs

The Update contact field step requires one-time manual field mapping after importing the snapshot. Open the workflow, click on the Update contact field step, and map each field using the Select field dropdown. See Step 4 above for the full mapping table.

Workflow shows errors on the Update contact field step

This is expected after importing the snapshot and is resolved by completing the field mapping in Step 4. Tags will still apply correctly even before field mapping is done.

Workflow shows no response in Execution Logs

Check that the contact has a valid 10-digit US or Canada phone number with no leading 1, dashes, or spaces.

Account not linked error

Reinstall the app from the GHL Marketplace to re-link your RealValidito account.

Need help?

Contact us at contact@realvalidito.com or visit our contact page. We provide 24×7 email support with responses typically within 1 business hour.


Related Resources