Setup Guide

How to setup ZipcodeInfo’s HubSpot Application:

  1. Click here to install the HubSpot Application
  2. Purchase a Subscription Here

After you’re subscription is live, be sure to complete the rest of your account information here:

Complete Profile Information

How to use the zipcode/address lookup feature:

  1. (see video below) Visit a contact, company or deal record and click US Address/Zipcode Search. Using it on deals? See Using the lookup on deals below for the extra setup steps.
  2. (see video below) Search an address and select the correct one, click copy all and then save.

Setup Guide

Set up US ZIP code & address lookup in HubSpot

Connect the app to your HubSpot portal, map your address fields, and start saving accurate US addresses in a few minutes. Here is the full walkthrough.

Step-by-step

1

Install from HubSpot

Click Install on HubSpot, choose the portal you want to connect, and approve the requested CRM scopes. You are redirected back to ZipcodeInfo when the connection is complete.

2

Start your subscription

Pick the $19/month plan and complete checkout. One subscription covers your whole portal with unlimited searches and unlimited users.

3

Complete your profile

Open your profile to confirm which HubSpot properties each address field maps to - street, city, state, county and ZIP code.

4

Look up an address

Open any contact, company or deal, click the US Address / Zipcode Search card, search an address or ZIP, pick the match and save.

Mapping your address fields

Each lookup returns the street, city, state, county and ZIP code. Map these to the HubSpot properties you already use - or create custom properties - so the data lands exactly where your reports and workflows expect it.

Accurate US address data

Results cover all 50 states with correct city, state, county and ZIP, so every saved record is consistent and reliable - improving segmentation, routing and reporting across your CRM.

Using the lookup on deals

The lookup card also works on HubSpot deal records. Deals have no built-in address fields, so there are a few extra steps:

  1. Create the deal properties. In HubSpot, go to Settings → Properties → Deal properties and create Address, City, State, County and Zip as Single-line text properties.
  2. Grant deal access. Click Install on HubSpot (again, if you are already connected), choose your portal and tick the optional deals permissions. Your subscription and field mappings are kept.
  3. Add the card to deals. Open any deal, click Customize record, and add the Zipcode Lookup card to the right sidebar.
  4. Optional: use your own deal properties. If your deals already have address properties, enter their internal names under HubSpot Deal Address Fields in your ZipcodeInfo profile.

Deal permissions show a padlock?

If HubSpot says “This permission is disabled for this app by an admin”, your portal uses App Governance and a Super Admin must allow the deal permissions first:

  1. In HubSpot, go to Settings → Integrations → Connected Apps → Approved apps.
  2. Select USA Zipcode Address Search and click Manage access.
  3. Open Data Permissions → Optional and enable the deal permissions (or click Enable all).
  4. Click Install on HubSpot again and tick the deal permissions.

Setup FAQs

Which HubSpot permissions (scopes) are required?
The app needs read and write access to contacts and companies so it can read the record you are on and write the selected US address back. Read and write access to deals is optional: tick it when you connect if you want to use the lookup on deals. No other data is accessed.
Can I change which HubSpot fields the address is saved to?
Yes. In your ZipcodeInfo profile you can map each part of the address (street, city, state, county, ZIP code) to any standard or custom HubSpot property. Deals have their own mapping under HubSpot Deal Address Fields.
The lookup card is not showing on my record - what do I check?
Make sure the install completed for the correct portal, that your subscription is active, and that you are viewing a contact, company or deal record. On deals, the card only appears once the deal permissions have been granted. A quick page refresh in HubSpot usually surfaces a newly installed card.
How do I use the lookup on deals?
Create Address, City, State, County and Zip deal properties in HubSpot (Single-line text). Then click Install on HubSpot again and tick the deal permissions; your existing settings are kept. Finally, open a deal, click Customize record, and add the Zipcode Lookup card to the right sidebar.
The deal permissions show a padlock - what do I do?
Your portal uses HubSpot App Governance, so a Super Admin must allow them first. In HubSpot, go to Settings, Integrations, Connected Apps, Approved apps, select USA Zipcode Address Search, click Manage access, then Data Permissions, Optional, and enable the deal permissions (or click Enable all). Then click Install on HubSpot again and tick them.
Do I need to install it for each user?
No. Install once per HubSpot portal and every team member can use it - there are no per-seat charges.

Ready to go?

Install the app and start saving accurate US addresses to HubSpot.

Install on HubSpot View on HubSpot