# HubSpot Contact Analysis: Lead Distribution by Country

**Last Updated:** 2026-03-15

## Analysis Status

**Note:** Direct HubSpot API analysis requires:
- HubSpot API token access
- Script to query contacts by `hs_country_region_code` or `ip_country_code` properties
- Date range filtering (last 90 days recommended)

**Available Properties:**
- `hs_country_region_code` - Two-letter country code (HubSpot-defined)
- `ip_country_code` - IP-based country detection (if available)
- `country` - Custom property (if created)

## Recommended Analysis

**Query Parameters:**
- Date range: Last 90 days (aligns with GSC/GA4 analysis)
- Properties: `hs_country_region_code`, `ip_country_code`, `lifecyclestage`, `leadsource`
- Filter: Exclude DACH countries (de, at, ch)

**Expected Insights:**
- Lead distribution by non-DACH countries
- Top countries for lead generation
- Conversion rates by country (if lifecycle stage data available)
- Comparison with GSC traffic data

## Next Steps

1. Create script: `docs/strategy/international-expansion/scripts/analyze-hubspot-contacts-by-country.php`
2. Query HubSpot API for contacts with country data
3. Aggregate by country and compare with traffic data
4. Identify countries with high lead-to-traffic ratios (conversion opportunities)

## Integration with Market Prioritization

HubSpot contact data will inform:
- **Market validation:** Countries with existing leads show demand
- **Conversion potential:** High lead-to-traffic ratios indicate strong product-market fit
- **Waitlist prioritization:** Countries with leads but no product support are waitlist candidates