Get Started with GetAddress
Use GetAddress from a standalone web page or follow the steps below to install it in your HubSpot portal.
Choose your workflow
Use the standalone web lookup
Choose Standard or Enterprise, sign in, and open the browser lookup. No HubSpot installation or Hub ID is required.
Standalone setupInstall in HubSpot
Create an account, connect the app with OAuth, add the CRM card and optionally configure custom field mappings.
HubSpot setup stepsAlready installed / have an account?
(Or upgrading from UKPostcodes.org / ZipcodeInfo.org)
Create Your Account
Visit the pricing page and choose the plan that suits your team, or start with a free trial — no credit card required.
The free trial includes 5 lookups. Both paid plans include unlimited HubSpot CRM-card searches; standalone web lookup includes 100 monthly searches on Standard and 250 on Enterprise.
Install the HubSpot App
After registration, click here to install GetAddress directly into your HubSpot portal.
You will be asked to grant permissions for reading and writing Contact and Company records, plus optional access to Deal records. The install flow will securely link your HubSpot portal to your GetAddress account using OAuth.
You can also find the app on the HubSpot Marketplace.
Add the Card to Your Record Layout
After installing the app, you need to add the Address Lookup card to your Contact, Company and Deal record layouts. Follow these steps:
Customise Record
Open any Contact, Company or Deal record in HubSpot CRM and click "Customise record".
Select the Right Sidebar
Select the "Default view", or the view you're using, to edit it.
Add a Card
Click "Add card" to view the available cards you can add to the sidebar.
Select Address Lookup
Find "Address Lookup" in the list and select it to add the card to your layout.
Save and Exit
Click "Save and exit" to apply your changes.
You only need to do this once — the card will then appear on all records of that type. Repeat for Contacts, Companies and Deals if you want it on each.
Search for an Address
Open any Contact, Company or Deal record and find the Address Lookup card in the right sidebar. Click the "Address Lookup" button to open the search modal.
You will see country tabs for all supported regions:
- UK — Enter a UK postcode (e.g. SW1A 1AA) and click Search
- US — Start typing an address and select from autocomplete suggestions
- Ireland — Enter an Eircode (e.g. D02 AF30) and click Search
- France — Search by address or postcode
- Belgium — Search by postcode, street, and house number
- Spain — Search by address or location name
- Germany — Start typing an address and select from autocomplete suggestions
Select the correct address from the results. Click "Copy to Edit Fields" to populate the editable fields on the right, then click "Save to HubSpot".
Save to HubSpot
Review the address fields (Address, City, State/County, Postcode/ZIP). Make any adjustments if needed, then click "Save to HubSpot".
The address data is written directly to the Contact, Company or Deal record in your HubSpot CRM. You will see a success confirmation, and the modal will close automatically. The record's address fields update in-place — no page reload needed.
Configure Field Mapping (Optional)
If your HubSpot portal uses custom property names for address fields, you can configure field mapping:
- Go to your WordPress profile page
- Scroll down to the HubSpot Field Mappings section
- For both Contacts and Companies, use the dropdowns to map each standard field (Address, City, State, County, ZIP) to the corresponding HubSpot property in your portal
- Click Update Profile to save your mappings
If no mapping is set, GetAddress uses the default HubSpot property names.
Important: Address Line 2
- Without any setup, Address Line 2 is added to the end of the Address field (for example “Flat 2, 10 High Street”), so it is never lost.
- To keep it in a separate field, HubSpot needs an Address Line 2 property. Companies have one built in (
address2). For Contacts, create a property in HubSpot property settings with the internal nameaddress2, or choose an existing property in the Address Line 2 mapping dropdown above. - Then, on your WordPress profile, enable Update Address Line 2 under Optional Address Fields.
- Create or map the property before enabling the option. If the property does not exist in HubSpot, saves that include Address Line 2 will fail.
Use GetAddress on Deals
The Address Lookup card also works on Deal records, so your team can capture an accurate delivery address on the deal before it moves to quote, order and despatch. Deals have no built-in address properties, so there are a few extra steps:
- Grant deal access. New installs are asked for it during install. If you installed before deal support was added, reconnect HubSpot once using the link shown in the lookup window or on your profile page.
- In HubSpot, create deal properties for the address (for example Address, Address 2, City, County and Postcode) under Settings → Properties → Deal properties.
- On your WordPress profile, check the Deal Field Mapping table. Properties named Address, Address 2, City, County and Postcode are used by default; pick different properties if yours have other names.
- Add the Address Lookup card to the deal record sidebar (Customise record → Right sidebar → Add card).
Deal permissions show a padlock?
The message “This permission is disabled for this app by an admin” means your HubSpot account uses app approvals. A Super Admin needs to go to Settings → Integrations → Connected Apps → Approved apps, open GetAddress, click Manage access and switch on the deal permissions under Data Permissions (or click Enable all). Then reconnect HubSpot and tick the deal permissions.
Bulk Address Validation and the Contact Map work with contacts and companies only.
Bulk Update & Contact Map
Enterprise subscribers also have access to two additional tools.
Bulk Address Validation
Access the Bulk Update page to review and update addresses across your entire CRM database.
The interface displays a paginated table of all contacts (or companies). For each row, click the search icon to open a multi-region address search modal. Select the correct address, mark the row for update, and then click "Update All Selected" to batch-save changes back to HubSpot.
Contact Map View
Access the Contact Map page to visualise your contacts and companies on an interactive Google Map.
Click "Sync & Refresh" to pull records from HubSpot and geocode their postcodes/ZIP codes. Markers appear with clustering for clean visualisation. Click any marker to see contact details in an info window.
Postcode Lookup on HubSpot Forms
Add UK postcode lookup to forms built in HubSpot's forms editor. Visitors pick their address from a list and the address fields fill in, including on conditional fields that only appear for some answers.
Create a key for your websites on your profile page, build the code with the generator there, and paste it above your form. The HubSpot Forms setup guide covers each step.