Phone Syntax Valid Property
Track which contact phone numbers have valid formatting with automatic format status tracking
Overview
Section titled “Overview”Clean Dial’s Phone Syntax Valid property automatically tracks whether each contact’s phone number is properly formatted. This boolean (true/false) property gives you instant visibility into which contacts have parseable, correctly structured phone numbers versus those with formatting issues like missing digits, invalid characters, or nonsense entries.
This is different from HLR lookup (which checks if a number is reachable). Phone Syntax Valid answers a simpler question: “Is this actually a phone number?”
Phone Syntax Valid Custom Property
How It Works
Section titled “How It Works”When contacts pass through either a Clean Dial Format Phone Number or HLR Lookup workflow action, the system automatically:
- Attempts to parse the phone number using Clean Dial’s parsing engine
- Determines if the number has a valid structure (correct length, valid country code, no weird characters)
- Sets the Phone Syntax Valid property to either
trueorfalseon the contact record
This happens seamlessly in the background - no additional setup required in your workflows.
What Makes a Format “Valid”?
Section titled “What Makes a Format “Valid”?”A phone number format is considered valid when it:
- Can be successfully parsed as a phone number
- Has the correct number of digits for its country
- Contains only valid phone number characters
- Matches a recognizable phone number pattern
A phone number format is considered invalid when it:
- Contains letters or special characters (e.g., “abc123”, “CALL-NOW”)
- Has too few or too many digits
- Doesn’t match any country’s phone format
- Is clearly not a phone number (e.g., “N/A”, “unknown”, “12345”)
Setting Up the Custom Property
Section titled “Setting Up the Custom Property”How to Track Phone Format Quality in HubSpot | Clean Dial Phone Syntax Valid
To view format status on your contact records:
- Navigate to CRM > Contacts
- Select any contact record
- Go to Key Information section
- Click Actions > Customize Properties
- Search for “Phone Syntax Valid” under the Clean Dial section
- Add the property to display on contact records
Benefits
Section titled “Benefits”Data Quality Management
- Instantly identify contacts with garbage phone data
- Filter out unparseable numbers before they waste time
- Track phone data quality across lead sources and imports
Workflow Efficiency
- Skip formatting/HLR lookup for numbers that can’t be parsed
- Create data hygiene workflows to flag or fix bad entries
- Route only contacts with real phone numbers to sales teams
Import & Migration Cleanup
- Quickly assess the quality of imported contact lists
- Identify data entry mistakes before they cause problems
- Segment contacts by phone data quality for targeted cleanup
Use Cases
Section titled “Use Cases”Imported List Cleanup - After importing trade show leads or purchased lists, filter by Phone Syntax Valid = false to see exactly which contacts have unusable phone data that needs attention.
Data Entry Error Detection - Create workflows that notify your team when new contacts have Phone Syntax Valid = false, catching typos and mistakes immediately.
Lead Source Quality Analysis - Compare phone format validity rates across different marketing channels to identify which sources deliver clean vs. messy data.
Pre-HLR Filtering - Use Phone Syntax Valid as a gate before running paid HLR lookups. Why pay to check “CALL ME LATER” or “555-FAKE”?
Database Health Reporting - Build dashboards showing what percentage of your contacts have properly formatted phone numbers, tracking data quality over time.
Technical Details
Section titled “Technical Details”- Property Type: Boolean (true/false)
- Property Name:
phone_syntax_valid - Scope: Contact records only
- Automatic Updates: Yes, updates when contacts flow through Format or HLR Lookup actions
- Default Value: No default (blank until first format/HLR lookup event)
Phone Syntax Valid vs HLR Status
Section titled “Phone Syntax Valid vs HLR Status”| Property | What It Checks | Example: +14155552671 | Example: “call-me” |
|---|---|---|---|
| Phone Syntax Valid | Is this a parseable phone number structure? | true | false |
| HLR Status | Is this number actually reachable/callable? | LIVE or DEAD (depends on carrier check) | N/A (can’t check unparseable input) |
Use Phone Syntax Valid to filter out garbage data. Use HLR Status to filter out disconnected or invalid numbers that look real but don’t work.
Frequently Asked Questions
Section titled “Frequently Asked Questions”Q: When does this property get updated?
A: The property updates whenever a contact flows through either the Format Phone Number or HLR Lookup workflow actions.
Q: Can a number be “format valid” but still show as DEAD in HLR Status?
A: Yes. A number like +14155552671 has valid formatting (it’s structured correctly), but the HLR lookup might find it’s disconnected or not in service. Format valid = “looks like a phone number.” HLR Status = “is this number actually live?”
Q: What happens to contacts processed before this feature existed?
A: The property only applies to contacts processed after feature activation. Existing contacts will have a blank value until they flow through a Clean Dial action.
Q: Can I use this property in HubSpot workflows?
A: Yes, you can filter and trigger workflows based on the Phone Syntax Valid property value.
Q: Does this cost extra?
A: No, Phone Syntax Valid is set automatically as part of both the Format Phone Number (free, unlimited) and HLR Lookup actions at no additional charge.