RealValidito GoHighLevel Integration — Help & Setup Guide

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 Connect GoHighLevel.
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 My Account → API Credentials and scroll down to the GHL Workflow — Import Pre-Built Workflow card. 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. Until a contact field is picked in every row, GHL shows “Custom field not found”. This disappears once each row has its RV field.

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

RealValidito Phone & DNC Lookup

RealValidito Phone Lookup

In GHL these values appear as “RealValidito . #1 Phone Lookup . Is Valid” and so on. The “.1” is the action’s number in the workflow; a second lookup action of the same kind becomes “.2”.

RealValidito DNC Lookup

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.

Other RealValidito Actions

The imported snapshot also contains two more ready-made workflows, RealValidito DNC Lookup and RealValidito Phone & DNC Lookup, already set up with the RV fields (their field mapping is in Step 4). Publish only one of the three RealValidito workflows in a sub-account. Each published one runs for every new contact and uses its own credits.

DNC Lookup (action “DNC Lookup”), for US numbers: checks the Federal DNC list, the TCPA litigator list and the state DNC lists of Texas, Florida, Pennsylvania, Indiana, Colorado and Wyoming. Uses 1 DNC Lookup credit per contact. Its values start with rv_dnc_lookup.1., for example {{rv_dnc_lookup.1.is_dnc}}:

• RV Is TCPA — true if the number belongs to a known TCPA litigator
• RV Is Federal DNC — true if the number is on a do-not-call list we check (Federal or state), and also true for TCPA litigators
• RV Is State DNC — true if the number is on the DNC list of one of the 6 states above
• RV State DNC Reason — the state DNC list(s) matched, e.g. Texas-DNC

All values false means the number was not found on these lists at the time of the lookup. A number that is not valid also comes back all false, so for a full check use Phone & DNC Lookup, which tells you both.

Phone & DNC Lookup (action “Phone & DNC Lookup”): both checks in one step. Uses 1 Phone Lookup credit and 1 DNC Lookup credit per contact (you need both). It returns all 13 values, the 9 Phone Lookup ones and the 4 DNC ones above, starting with rv_phone_dnc_lookup.1., for example {{rv_phone_dnc_lookup.1.is_valid}}, {{rv_phone_dnc_lookup.1.line_type}} or {{rv_phone_dnc_lookup.1.is_dnc}}.

Using an action in your own workflow: click +, search RealValidito and choose the action. Then add Update contact field and pick the RV field in each row’s Select field dropdown.

RealValidito is a compliance-assistance tool, not legal advice.

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 number is valid (follows NANP rules and is assigned to a carrier)
• RV Line Type — Mobile, Landline, VoIP, Toll-Free, or Unknown
• RV Carrier — current carrier name, including ported numbers (LNP)
• 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 the number is on a do-not-call list we check (Federal or state), and also true for TCPA litigators
• RV Is State DNC — true if the number is on the DNC list of Texas, Florida, Pennsylvania, Indiana, Colorado or Wyoming
• 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 — the number is on a do-not-call list we check (Federal or state). Numbers of TCPA litigators get the tcpa-litigator tag instead.
• state-dnc — number is on a State DNC list (Texas, Florida, Pennsylvania, Indiana, Colorado, Wyoming)
• dnc-clean — the number was not found on any of these lists at the time of the lookup. In the DNC Lookup workflow, a number that is not valid is not checked and also gets this tag; use Phone & DNC Lookup for a full check.

Phone Tags

• invalid-phone — number is invalid (fails NANP rules or is not assigned to a carrier)
• mobile-number — number is a mobile line
• landline-number — number is a landline (usually cannot receive SMS)
• voip-number — number is a VoIP line
• 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 Valid or Invalid status, line type, carrier, location data, timezone, and network domain. Deducts 1 Phone Lookup credit per contact.
• DNC Lookup — screens the number against the Federal (National) DNC list, the state DNC lists of Texas, Florida, Pennsylvania, Indiana, Colorado and Wyoming, and the TCPA litigator list. 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

The app is probably not installed in this sub-account. In the GHL Marketplace, open RealValidito → Install and choose this sub-account, then connect it (External Connection tab → Connect).

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 10-digit US or Canada number (a leading +1, dashes, spaces or brackets are fine).

Account not linked error

Open RealValidito in that sub-account, go to the External Connection tab, click Connect and sign in with your RealValidito account. You don’t need to reinstall the app; do this once in each sub-account.

Need help?

Contact us at support@realvalidito.com or visit our contact page. We usually reply within one business day.

Related Resources

• API Documentation
• Zapier Integration
• Phone Number Lookup
• DNC Lookup
• Pricing