How a phone number becomes a TPS/CTPS verdict.

1. 1. Connect

   Install the marketplace app for your CRM, or request an API key for any other system (issued within one working day). The native apps request the scopes they need (contacts, companies, leads, accounts, plus the automation surface) and create the tps_status property and supporting fields on the right objects. The API route works the same way: send us a number, get a verdict.

2. 2. Configure

   Pick which phone fields to screen, how often, and how you want the verdict to behave. Single combined status or separate TPS and CTPS verdicts. Hide listed numbers from your reps, or just flag them for review. Daily backfill on or off. UK-only or handle international numbers as out-of-scope. Save once.

3. 3. Run

   Real-time on change: when a phone number is added or modified, TPSClear catches the webhook, normalises the number, queries the TPS and CTPS registers, and writes the verdict back to the record. A daily backfill sweeps anything missed. Where the CRM supports it, a native workflow action lets you trigger screening explicitly inside any automation.

Architecture in one diagram

The whole loop, end to end. Same shape for every integration. Whichever CRM you use, or whether you call the API directly, the flow between TPSClear and the UK TPS/CTPS data sources is the same.

The verdicts

TPSClear writes one of these values to tps_status on the record:

• Not a valid UK number Empty, non-UK, or unparseable; fix the record before dialling.
• Unknown (check failed) A register lookup could not be completed; re-screened automatically, never assumed Clean.
• Clear Number is valid UK and not on TPS or CTPS.
• TPS-listed Number sits on the personal TPS register. Unsolicited marketing calls are unlawful unless the contact has given specific consent.
• CTPS-listed Number sits on the corporate CTPS register. Same rules apply for B2B unsolicited calls.

Need raw fields for reporting? You also get tps_listed, ctps_listed, and tps_screened_at as separate properties on every integration.

What works on which CRM

Every integration ships with the same screening engine and the same verdicts. The differences are in how each CRM lets us hook into record changes and automation.

Or just use the API

If your CRM is not on the list, or you want to screen numbers from a custom system, a call centre dialler, a marketing automation tool, or a data warehouse, the TPSClear API does the same job in one HTTPS call.

curl -X POST https://api.tpsclear.co.uk/v1/screen \
  -H "Authorization: Bearer $TPSCLEAR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"phoneNumbers": ["+447700900123"]}'

# response
{
  "results": [
    {
      "phoneNumber": "+447700900123",
      "tpsListed": false,
      "ctpsListed": false,
      "status": "clean",
      "checkedAt": "2026-05-08T09:00:00Z"
    }
  ]
}

Bulk endpoint, webhooks for re-screen events, and rate limits are all documented on the developer page.

Read the API docs

Call from HubSpot with a built-in gate

TPSClear can also act as a calling provider inside HubSpot. When a rep clicks the call button, the TPSClear Gate opens next to the record, screens that number against TPS and CTPS at that exact moment, and shows a hard DO NOT CALL before anyone dials. Callable numbers get a click-to-call link on the rep's own phone or headset, and the call is logged back to the record; no separate dialler required.

The Gate is in beta while it goes through HubSpot certification. If you want early access, get in touch.