Backfill Geo Data
Skill ActiveEnrich missing geographic data (country, state, city) on contacts and companies using HubSpot workflows, external data providers, or IP-based geolocation.
To automatically populate missing geographic information on contacts and companies in HubSpot, enabling better segmentation, regional reporting, and compliance.
Features
- Enriches missing country, state, and city data
- Supports HubSpot workflows for automated enrichment
- Provides API-based enrichment using company domain lookups
- Integrates with third-party data providers
- Includes detailed step-by-step instructions and rollback procedures
Use Cases
- Use when contacts or companies lack essential geographic data for reporting or targeting.
- Use to comply with regional privacy laws (e.g., GDPR) by accurately assigning location data.
- Use to improve lead routing and territory assignment based on location.
- Use to standardize geographic data across your HubSpot database.
Non-Goals
- Overwriting manually entered geographic data
- Performing operations outside of HubSpot CRM data enrichment
- Replacing HubSpot's core CRM functionality
Documentation
- info:Configuration & parameter referenceThe SKILL.md mentions prerequisites like an API token and Python installation but does not detail specific configuration parameters or their defaults for the enrichment methods.
Maintenance
- warning:Dependency ManagementThe skill requires Python with 'hubspot-api-client' installed via 'uv', but there is no explicit mention of vulnerability checks or an automated update mechanism for dependencies.
Security
- warning:Secret ManagementThe SKILL.md requires a HubSpot API token in '.env', but does not detail measures to prevent its echo or secure handling beyond a generic mention.
Code Execution
- info:ValidationThe skill mentions validating against standardized geo formats but does not specify the use of a schema library for input or output validation within the provided description.
- info:Error HandlingThe SKILL.md outlines a rollback procedure but does not detail specific error handling for API calls or script execution, nor does it specify structured error fields.
Compliance
- info:GDPRThe skill operates on contact and company data which may include personal data, but it does not explicitly describe sanitization steps before sending data to HubSpot or other providers beyond the implied data quality focus.
Install
- warning:Installation instructionThe README provides installation instructions for the plugin marketplace but does not include a direct copy-paste invocation example for this specific skill, nor does it detail HubSpot API authentication setup beyond mentioning a token in .env.
Errors
- info:Actionable error messagesThe SKILL.md mentions a rollback procedure and the need to validate against standardized geo formats but does not explicitly detail actionable error messages for user-facing failure paths.
Execution
- warning:Pinned dependenciesThe skill requires 'hubspot-api-client' installed via 'uv' but does not specify pinned versions or a lockfile, potentially leading to compatibility issues.
Protocol
- info:Idempotent retry & timeoutsWhile HubSpot API interactions might have inherent idempotency and timeouts, the skill description does not explicitly detail how these are managed or exposed to the user for retry guidance.
Practical Utility
- warning:Usage examplesThe SKILL.md describes methods and provides a Python code snippet but lacks end-to-end, ready-to-use examples demonstrating input, invocation, and observable outcome for each enrichment method.
- info:Edge casesThe SKILL.md mentions a rollback procedure and the need to validate against standardized geo formats, but doesn't explicitly detail failure modes with symptoms and recovery steps for each enrichment method.
Safety
- info:Halt on unexpected stateWhile a rollback procedure is mentioned, the SKILL.md does not explicitly state that the workflow will halt and report on unexpected pre-states like a dirty working tree or drifted schema.
Installation
First, add the marketplace
/plugin marketplace add TomGranot/hubspot-admin-skills/plugin install hubspot-admin-skills@hubspot-admin-skillsQuality Score
Trust Signals
Similar Extensions
Enrich Contact Industry
99Backfill contact-level industry from associated company records using a HubSpot workflow. Enables industry-based segmentation for targeted campaigns aligned with ICP verticals.
Lifecycle Progression Workflow
100Build workflows to automate contact progression through the sales funnel: Lead to MQL to SQL to Opportunity to Customer. Each transition is triggered by a specific event (score threshold, meeting booked, deal created, deal won).
Cleanup Dashboards
100Audit and consolidate HubSpot reporting dashboards. Identifies unused, duplicate, or outdated dashboards. Must be performed manually — no dashboard API is available.
Reassign Deactivated Owners
99Reassign contacts and companies from deactivated team members to active owners. Fully automated via the HubSpot Owners API and Batch Update API. Includes territory analysis for informed reassignment decisions.
Weekly Cleanup Routine
98A lightweight 5-minute weekly health check covering bounce monitoring, new contact quality, workflow health, list growth trends, and data quality sampling. Quick early warning system, not a comprehensive audit.
Review Bounced Contacts
98Weekly manual review of contacts with 3+ bounce events. Decide whether to delete or attempt recovery for each flagged contact. Prevents over-suppression while removing truly bad data.