Skip to content

Cross-field consistency check: phone country code vs. address country

One of 565 written HubSpot workflow specs, by a collective of independent HubSpot consultants.

Professional

Seat pricing: Professional edition. To build it, a GTM Seat or an Ops Seat (an Ops Seat cannot create marketing emails or sequences). Per-hub plans: Data Hub Professional.

Contact6 stepsUpdated for HubSpot seat pricing
OutcomeContacts whose phone number's country calling code clearly disagrees with their stated address country are flagged for a look, catching mismatched or copy-pasted contact records before a call goes to the wrong country's sales rep or time zone.
Workflow mapdata-quality-029
Phone number and Country/Region known leads to Custom code: extract calling code, compare to country table. Custom code: extract calling code, compare to country table leads to Result. Result leads to match: Status: Consistent; ambiguous: Status: Ambiguous - shared calling code; mismatch: Status: Mismatch - needs review. Status: Mismatch - needs review leads to Create task. match ambiguous mismatch Phone number and Country/Region known Custom code: extract calling code, compare to country table Result Status: Consistent Status: Ambiguous - shared calling code Status: Mismatch - needs review Create task
Phone number and Country/Region known leads to Custom code: extract calling code, compare to country table. Custom code: extract calling code, compare to country table leads to Result. Result leads to match: Status: Consistent; ambiguous: Status: Ambiguous - shared calling code; mismatch: Status: Mismatch - needs review. Status: Mismatch - needs review leads to Create task. match ambiguous mismatch Phone number and Country/Region known Custom code: extract calling code, compare to country table Result Status: Consistent Status: Ambiguous - shared calling code Status: Mismatch - needs review Create task

When to use it, when not to

Use it

  • Use it once phone numbers and country values are already reasonably normalized, see data-quality-003 for phone format and data-quality-004 for country normalization. A consistency check built on messy inputs on both sides mostly produces noise.
  • Use it as a light sanity check, not a hard rule. A contact can legitimately carry a phone number from a country other than where they currently live, an expat, or a second office line.
Read more on when to use itShow less

Skip it

  • Do not use it on portals where Country or Phone number is rarely populated; a check that can only run on a small fraction of records is not worth the build effort yet.
  • Do not use it expecting precise country detection from a phone number alone. Several countries share the same calling code, for example the North American Numbering Plan covers the United States, Canada, and a number of Caribbean nations all under +1, so this fiche treats those as ambiguous rather than a firm mismatch.
Read more on when to skip itShow less

The rest of this spec

Prerequisites · 4 items

Every property with its label, internal name, type and options, plus the assets the workflow needs.

Enrollment · 4 parts

The trigger, the criteria as ticked in the UI, the re-enrollment rule and the suppression list.

Steps · 6 numbered actions

Each action in order with its parameters, branches and delays.

Known pitfalls · 4

Traps seen in production, each with what breaks and what to do instead.

Test plan and UAT script · 5 cases, 3 variants

How to prove it works in a test portal, one case per branch, and a sign-off sheet.

Files · PDF, Markdown, JSON, CSV, code

The properties JSON creates the fields in one call. The workflow JSON documents the build. The custom coded action ships as a ready-to-paste .js file.

Install · 1 click, switched off

The installer creates the properties and the workflow, switched off, then opens a task for what it cannot create. Nothing is deleted, enabled or enrolled.

Unlock all 565 specs, 149 EUR

One-time, excl. VAT. 30-day refund. Installs in 3 portals. Founding price until 30 November.

Read the free Data quality spec

Read 12 complete specs before you pay.

One per category, same format as the paid ones. Email only, no card.

We email the link, then a short note when specs change. Nothing else.

149 EUR199

Full library, 565 specs
Get the full library