Getting Started with Address Geocoder

Address Geocoder converts street addresses into precise latitude and longitude coordinates directly inside your HubSpot workflows. Use it to enrich contact, company, deal, and ticket records with location data for radius searches, territory mapping, and geo-targeted campaigns.

How It Works

1. A HubSpot workflow triggers the Geocode Address action for a record
2. You provide the address fields - street, city, state, postal code, and country
3. The app looks up the address and returns GPS coordinates along with standardized address components
4. Your workflow branches based on whether geocoding succeeded, then uses the coordinates in subsequent steps

Key Capabilities

Multi-Object Support

The Geocode Address action works with contacts, companies, deals, and tickets. Any record type that has address properties can be geocoded.

Flexible Address Input

You don't need a complete address to get results. Provide as much or as little as you have - a full street address gives the most precise coordinates, but even a city and country or just a postal code will return a location.

Standardized Address Output

Beyond coordinates, the action returns a cleaned-up, standardized version of the address broken into individual components (street number, street name, city, state, postal code, country, and country code). This is useful for normalizing inconsistent address data in your CRM.

Workflow Branching

The action returns a success or failure result so you can branch your workflow accordingly - for example, routing records with valid coordinates to a territory assignment step and flagging records with bad addresses for review.

Quick Start

1. Install the app in your HubSpot portal (see the Installation Guide)
2. Configure your Google Maps API key in the Settings page
3. Add the Geocode Address action to a HubSpot workflow
4. Test by enrolling a record with a known address and checking the coordinates

Next Steps

• Installation Guide - connect your portal
• Geocode Address Action - learn about the workflow action inputs and outputs
• Settings Reference - full settings documentation