standardize-geo-values

Standardize country and state values to canonical names in HubSpot CRM.

58|16|Updated Mar 26, 2026
One-click install
npx skills add https://github.com/TomGranot/hubspot-admin-skills --skill standardize-geo-values
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: standardize-geo-values
Source: https://github.com/TomGranot/hubspot-admin-skills/tree/main/skills/standardize-geo-values
Command: npx skills add https://github.com/TomGranot/hubspot-admin-skills --skill standardize-geo-values

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires requests, python-dotenv, and includes scripts (resource) components.

What problem does it solve?

Converts inconsistent country and state/region values into a single, standardized set across HubSpot Contacts and Companies to improve geographic segmentation and reporting accuracy.

Core Features & Use Cases

  • Audit and identify non-standard geo values across Contacts and Companies.
  • Build and maintain a mapping table from variants to canonical values (e.g., "US"/"USA"/"U.S." -> "United States"; "NY" -> "New York").
  • Perform batch updates via HubSpot API or bulk UI workflows with safeguards and retry logic.
  • Enforce standardization going forward by validating form dropdowns and preventing free-text deviations.
  • Verify results with before/after checks and export audit trails for compliance and traceability.

Quick Start

Audit your HubSpot data for non-standard country and state values, run the Included Before/Execute/After workflow to apply the mappings, and verify that all records reflect standardized geographic values.

Frequently Asked Questions about standardize-geo-values

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I standardize country and state values in HubSpot CRM contacts and companies?▼

This skill standardizes inconsistent geographic data by mapping non-standard country and state variants like "USA" or "NY" to canonical full names across HubSpot contacts and companies through API-driven batch updates with before/after validation checks.

What is the best way to normalize free-text geography data in HubSpot for accurate reporting?▼

Normalizing free-text geography data involves building a mapping table to convert variants into a single standardized set, enforcing form dropdown validations to prevent deviations, and exporting audit trails for compliance and traceability.

Can I run a bulk data cleanup for non-standard geo values using the HubSpot API?▼

Yes, bulk data cleanup for non-standard geo values is possible using the HubSpot API by applying mapping tables to contacts and companies with built-in safeguards and retry logic for reliable batch updates.

How do I audit HubSpot contacts and companies for inconsistent country and region formats?▼

You audit HubSpot records for inconsistent country and region formats by scanning contacts and companies to identify non-standard geo values, then generating before and after checks to verify overall data hygiene compliance.

Does this data hygiene approach require Python and API credentials to update HubSpot records?▼

Yes, standardizing HubSpot records requires Python with the requests library and python-dotenv for environment management to authenticate and execute API-driven batch updates safely.