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
- Go to the GoHighLevel App Marketplace and search for RealValidito, or use this direct install link: Install RealValidito.
- Click Install. You’ll be redirected to RealValidito’s secure account linking page.
- Log in with your RealValidito account credentials and click Link Account.
- You’ll see a GoHighLevel Connected! confirmation. Authentication is automatic using your GHL location ID — no API key required.
Step 3: Create Custom Fields in GHL
Before setting up your workflow, create a custom fields folder in GHL to store the RealValidito lookup results on each contact record.
- Go to Settings → Custom Fields in your GHL sub-account.
- Click Create folder, name it RealValidito, select object Contact, and click Create.
- Click + Create field and add the following 9 fields — all as Single line type, object Contact, folder RealValidito:
- RV Phone Status — whether the number format is valid (true/false)
- RV Line Type — Mobile, Landline, VoIP, or Toll-Free
- RV Carrier — the carrier name with real-time LNP detection
- RV State — state associated with the number
- RV City — city associated with the number
- RV Country — country associated with the number
- RV ZIP — ZIP code associated with the number
- RV Is DNC — whether the number is on the Federal DNC registry (true/false)
- RV Is TCPA — whether the number is a known TCPA litigator (true/false)
Step 4: Set Up Your Workflow
Follow these steps to build a workflow that automatically validates every new contact. Here is an overview of the complete workflow you will build:
4.1 Create a New Workflow
- Go to Automation → Workflows and click + Create Workflow.
- Select Start from Scratch.
- Set the trigger to Contact Created.
4.2 Add the RealValidito Action
- Click the + button below the trigger to add an action.
- Search for RealValidito and select Phone & DNC Lookup.
- The Phone Number field will be automatically mapped to
{{contact.phone}}. - Click Save action.
4.3 Add Update Contact Field Action
- Click the + button below the RealValidito action.
- Search for Update contact field and select it.
- Set Action Type to Update field data.
- For each field, click the Custom variable picker icon on the right side of the value field, then navigate to RealValidito → #1 Phone & DNC Lookup and select the matching variable:
- RV Phone Status → select Is Valid
- RV Line Type → select Line Type
- RV Carrier → select Carrier
- RV State → select State
- RV City → select City
- RV Country → select Country
- RV ZIP → select ZIP
- RV Is DNC → select Is DNC
- RV Is TCPA → select Is TCPA
Click Save action.
4.4 Add If/Else Condition
- Click the + button below the Update Contact Field action.
- Search for If/Else and select it.
- Set up the following branches in order:
- Branch 1 — DNC: Is DNC = true → Add tag
do-not-call - Branch 2 — TCPA: Is TCPA = true → Add tag
tcpa-litigator - Branch 3 — Invalid: Is Valid = false → Add tag
invalid-phone - Branch 4 — VoIP: Line Type = voip → Add tag
voip-number - Branch 5 — Landline: Line Type = landline → Add tag
landline-number - None (all others): → Add tag
phone-verified
Click Save action, then click Save and toggle the workflow to Publish.
Step 5: Test Your Workflow
- Create a new contact with a real US or Canada phone number.
- The workflow will trigger automatically within seconds.
- Go to Execution Logs to confirm all steps show Executed status.
- Open the contact record and scroll to the RealValidito section to see all 9 fields populated with the lookup results.
- Check the contact tags to confirm the correct tag was applied based on the result.
What the Lookup Returns
- RV Phone Status — true (valid format) or false (invalid format)
- RV Line Type — Mobile, Landline, VoIP, or Toll-Free
- RV Carrier — carrier name with real-time LNP (number porting) detection
- RV State, City, Country, ZIP — location data associated with the number
- RV Is DNC — true if listed on the Federal Do Not Call registry
- RV Is TCPA — true if the number is a known TCPA litigator
Tags Applied Automatically
- do-not-call — number is on the Federal DNC registry
- tcpa-litigator — number is a known TCPA litigator
- invalid-phone — number has an invalid format
- voip-number — number is a VoIP line (TCPA risk for auto-dialing)
- landline-number — number is a landline (SMS will not be delivered)
- phone-verified — number passed all checks, safe to contact
Available Workflow Actions
- Phone Lookup — validates the phone number and returns line type, carrier, active/inactive status, and location data.
- DNC Lookup — screens the number against the Federal DNC registry and TCPA litigator databases.
- Phone & DNC Lookup — runs both Phone Lookup and DNC Lookup in a single workflow step.
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
Make sure you selected the field values using the Custom variable picker icon and not by typing manually. Navigate to RealValidito → #1 Phone & DNC Lookup in the picker and select each field.
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.