Phone validation for GoHighLevel

Option 1: call the API from GoHighLevel

GoHighLevel workflows include a Custom Webhook action that can POST to an external URL with your own headers and JSON body, so a workflow can send a new contact's phone number to the TrueSearch API.

1. Method POST to https://truesearch.app/api/business/scrub
2. Header x-api-key: ts_live_… (or Authorization: Bearer ts_live_…) and Content-Type: application/json
3. Body {"numbers": [...]} with up to 1,000 numbers in any format
4. Read rows[].valid, lineType, carrier and keep from the response

curl https://truesearch.app/api/business/scrub \
  -H "Content-Type: application/json" \
  -H "x-api-key: ts_live_…" \
  -d '{"numbers":["+1317XXXXXXX","(317) XXX-XXXX"]}'

{"summary":{"total":2,"keep":1,...},
 "rows":[{"input":"+1317XXXXXXX","e164":"+1317XXXXXXX","valid":true,
          "lineType":"mobile","carrier":"…","keep":true,"reason":"ok"}, …]}

Option 2: connect through an automation tool

Use GoHighLevel as the trigger in an automation tool (for example, a new contact or lead), add an HTTP step that sends the phone number to the TrueSearch API, then write the result back to GoHighLevel or route the record based on keep.

Option 3: CSV export and import (no code)

1. Export the contacts, leads or list you want to check from GoHighLevel as a CSV file (if your account role allows exporting).
2. Upload the file to TrueSearch. CSV and Excel both work, and the phone column is found automatically.
3. Download the clean file. Every row gets valid, line_type and carrier columns, so you can filter out dead, landline or VoIP numbers.
4. Import the clean file back into GoHighLevel, or use it to update or tag the records you checked, the same way you normally import a list.

Results come back in about 30 seconds per 1,000 numbers.

What TrueSearch for Business does

Questions

Other integration guides